使用 Deep Research 取得報告

Deep Research 是 Made by Google 代理,可供使用者收集、分析及瞭解內外部資訊。

總覽

當您輸入提示給 Deep Research 時 (例如「比較範例專案的競爭對手」),Deep Research 會評估問題是否與研究相關,然後生成計畫,列出進行研究的步驟,並在研究過程中串流傳輸問題和答案。接著,這項工具會生成一份報告,列出發現內容和引文,並提供音訊摘要。

Deep Research 會使用應用程式建立索引的資料做為研究來源。如果應用程式已啟用網頁搜尋功能,Gemini 也能使用網頁搜尋結果。

以下列舉幾個 Deep Research 生成報告的範例提示:

  • 如何改善現有行動銀行應用程式的使用者體驗,使其更直覺易用?
  • 如何在尖峰時段縮短顧客等待時間,同時確保支援服務品質?
  • 分析中歐國家的經濟狀況。
  • 比較 BigQuery 與競爭對手,並以表格格式提供結果。

使用 Deep Research

使用者可以透過應用程式存取及使用 Deep Research。Deep Research 可存取應用程式已建立索引的資料,以及 (如果已啟用) 網頁搜尋結果。

您可以透過應用程式或 API 取得「深入研究」結果 (一般適用於許可清單)。

控制台

如要在應用程式中使用 Deep Research,請按照下列步驟操作:

  1. 在應用程式導覽選單中,前往「Deep Research」

  2. 按一下「來源」,選取代理程式必須納入的來源,以提供最相關的資料洞察。

    除了 Gemini Enterprise 來源,您也可以選擇納入 Google 搜尋結果。

  3. 輸入 Deep Research 的提示,然後按一下「Submit」。如果提示與研究無關,Deep Research 會生成答案。如果系統判定提示與研究相關,Deep Research 就會在研究計畫中列出代理程式預計研究的主題。

  4. 視需要編輯代理程式的提示,產生更符合您需求的新研究計畫。

  5. 如果研究計畫符合您的需求,請按一下「開始研究」

    代理程式會根據計畫開始研究:

    • 在研究過程中串流處理主題
    • 生成附有引文的調查結果報告
    • 生成 1 到 2 分鐘的報告語音摘要

REST

如要透過 API 使用 Deep Research,請按照下列步驟操作:

  1. streamAssist 方法傳送要求。

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    "https://discoveryengine.googleapis.com/v1/projects/project_id/locations/global/collections/default_collection/engines/app_id/assistants/default_assistant:streamAssist" \
    -d '{
         "query": {
           "text": "QUERY"
         },
         "agentsSpec": {
           "agentSpecs": {
             "agentId": "deep_research"
           }
         },
         "toolsSpec": {
           "vertexAiSearchSpec": {
             "dataStoreSpecs": {
               "dataStore": "projects/PROJECT_ID/locations/global/collections/default_collection/datastores/DATA_STORE_ID"
             }
           },
           "webGroundingSpec": {}
         }
        }'
    

    更改下列內容:

    • PROJECT_ID:您的 Google Cloud 專案 ID。
    • APP_ID:應用程式的 ID。
    • QUERY:查詢。
    • DATA_STORE_ID:應用程式有多個資料存放區時,資料存放區的 ID。指定這個選項後,搜尋範圍會限制在指定資料儲存庫中的文件。

    回應

    如果要求成功,您會收到類似下列回應的 JSON 回應。請注意 SESSION_ID。這是啟動下一個步驟研究程序的必要動作。

    [{
     "answer": {
       "name": "ANSWER_ASSIST_NAME",
       "state": "SUCCEEDED",
       "replies": [
         {
           "groundedContent": {
             "content": {
               "role": "model",
               "text": "INLINE_TEXT"
             }
           },
         },
         {
           "groundedContent": {
             "content": {
               "role": "model",
               "text": "INLINE_TEXT_WITH_RESEARCH_PLAN"
             },
             "contentMetadata": {
               "contentKind": "RESEARCH_PLAN"
             }
           },
         }
       ],
     },
     "sessionInfo": {
       "session": "SESSION_ID",
       "queryId": "QUERY_ID",
       "turnId": "TURN_ID"
     },
     "assistToken": "ASSIST_TOKEN"
    }
    ]
    
  2. 針對上一個步驟中的查詢啟動研究。如要這麼做,請對 streamAssist 方法發出另一項要求。在這項要求中,將查詢設為 Start Research,並加入上一個步驟中的工作階段資訊。

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    "https://discoveryengine.googleapis.com/v1/projects/project_id/locations/global/collections/default_collection/engines/app_id/assistants/default_assistant:streamAssist" \
    -d '{
         "query": {
           "text": "Start Research"
         },
         "session": "SESSION_ID",
         "agentsSpec": {
           "agentSpecs": {
             "agentId": "deep_research"
           }
         },
         "toolsSpec": {
           "vertexAiSearchSpec": {
             "dataStoreSpecs": {
               "dataStore": "projects/PROJECT_ID/locations/global/collections/default_collection/datastores/DATA_STORE_ID"
             }
           },
           "webGroundingSpec": {}
         },
        }'
    

    更改下列內容:

    • PROJECT_ID:您的 Google Cloud 專案 ID。
    • APP_ID:應用程式的 ID。
    • SESSION_ID:上一個步驟中的工作階段 ID。
    • DATA_STORE_ID:應用程式有多個資料存放區時,資料存放區的 ID。指定這個選項後,搜尋範圍會限制在指定資料儲存庫中的文件。

    回應

    如果要求成功,您會收到類似以下截斷回應的 JSON 回應。

    回應包含 AssistAnswer 資源的例項。

    這是串流回應,因此視研究回應中的資料量而定,可能需要一些時間才能完整串流。

    [{
     "answer": {
       "state": "IN_PROGRESS",
       "replies": [
         {
           "groundedContent": {
             "content": {
               "role": "model",
               "text": "RESEARCH_QUESTION_1"
             },
             "contentMetadata": {
               "contentKind": "RESEARCH_QUESTION",
               "contentId": "ID0"
             }
           },
         }
       ]
     },
     "assistToken": "ASSIST_TOKEN"
    },
    {
     "answer": {
       "state": "IN_PROGRESS",
       "replies": [
         {
           "groundedContent": {
             "content": {
               "role": "model",
               "text": "RESEARCH_ANSWER_1_PART_1"
             },
             "contentMetadata": {
               "contentKind": "RESEARCH_ANSWER",
               "contentId": "ID0"
             }
           },
         }
       ]
     },
     "assistToken": "ASSIST_TOKEN"
    },
    {
     "answer": {
       "state": "IN_PROGRESS",
       "replies": [
         {
           "groundedContent": {
             "content": {
               "role": "model",
               "text": "RESEARCH_ANSWER_1_PART_2"
             },
             "contentMetadata": {
               "contentKind": "RESEARCH_ANSWER",
               "contentId": "ID0"
             }
           },
         }
       ]
     },
     "assistToken": "ASSIST_TOKEN"
    },
    {
     "answer": {
       "state": "IN_PROGRESS",
       "replies": [
         {
           "groundedContent": {
             "content": {
               "role": "model",
               "text": "INLINE_TEXT"
             },
             "textGroundingMetadata": {
               "references": [
                 {
                   "documentMetadata": {
                     "document": "DOCUMENT_ID",
                     "uri": "DOCUMENT_REDIRECT_URI",
                     "title": "DOCUMENT_TITLE",
                     "pageIdentifier": "",
                     "domain": "DOCUMENT_DOMAIN"
                   }
                 }
               ]
               "searchEntryPoints": [
                 {
                   "renderedContent": "GROUNDING_SEARCH_ENTRY_POINT"
                 }
               ]
              }
            }
          }
        ]
      }
    },
    {
     "answer": {
       "state": "IN_PROGRESS",
       "replies": [
         {
           "groundedContent": {
             "content": {
               "role": "model",
               "file": {
                 "fileId": "AUDIO_FILE_ID"
               }
             },
             "contentMetadata": {
               "contentKind": "RESEARCH_AUDIO_SUMMARY"
             }
           },
         }
       ]
     },
     "assistToken": "ASSIST_TOKEN"
    }
    {
     "answer": {
       "name": "ANSWER_ASSIST_NAME",
       "state": "SUCCEEDED"
       },
     "sessionInfo": {
       "session": "SESSION_ID",
       "queryId": "QUERY_ID",
       "turnId": "TURN_ID"
     },
    "assistToken": "ASSIST_TOKEN"
    }]