使用 Deep Research 取得報告

Deep Research 是 Made by Google 代理,適合需要收集、分析及瞭解內外部資訊的使用者。

總覽

在 Deep Research 輸入提示詞 (例如「比較 Example Project 的競爭對手」) 後,Deep Research 會評估問題是否與研究相關、生成研究步驟計畫,並在研究過程中逐步提供常見問答。接著,系統會生成研究結果報告,並附上引用來源和語音摘要。

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

以下是 Deep Research 生成報告的提示範例:

  • 如何改善現有行動銀行應用程式的使用者體驗,讓操作更直覺、更容易使用?
  • 如何在不影響支援品質的情況下,縮短尖峰時段的客戶等待時間?
  • 分析中歐國家的經濟狀況。
  • 比較 BigQuery 與競爭對手,並以表格格式提供結果。

使用 Deep Research

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

您可以透過應用程式或 API (正式發布,但須加入許可清單) 取得 Deep Research 的結果。

控制台

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

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

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

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

  3. 輸入提示詞,然後點按「提交」。如果提示與研究無關,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"
    }]