建立 Cloud Assist 調查

本頁說明如何建立及查看 Gemini Cloud Assist 調查。

事前準備

  1. 確認專案已啟用下列 API：

    • cloudaicompanion.googleapis.com
    • cloudasset.googleapis.com
    • cloudresourcemanager.googleapis.com
    • geminicloudassist.googleapis.com
    • (建議) logging.googleapis.com
    • (建議) monitoring.googelapis.com

    如需啟用 API 的操作說明，請參閱「啟用及停用服務」。

  2. 如要取得建立調查所需的權限，請要求管理員授予您專案的調查建立者 (roles/geminicloudassist.investigationCreator) IAM 角色。

    這個預先定義的角色具備在專案中建立調查所需的權限。建立調查時，系統會授予您該調查的「調查擁有者」(roles/geminicloudassist.investigationOwner) IAM 角色，讓您查看調查結果。

  3. 可存取調查中的產品。

    執行調查時，Gemini Cloud Assist 會使用您的憑證存取 API 和資訊。也就是說，調查的存取權僅限於您擁有的存取權。

  4. 如要調查應用程式，該應用程式必須位於已啟用應用程式的資料夾中。

建立調查

控制台

  1. 如要建立新的調查，請按一下與進入點相關聯的「調查」按鈕。 建立調查的常見進入點是「Cloud Assist Investigations」(Cloud Assist 調查) 頁面。

    前往 Cloud Assist Investigations

  2. (選用) 輸入調查的名稱。

    您選擇的名稱會用於識別調查記錄中的這項調查。如果略過這個步驟，系統會自動產生調查名稱。

  3. 說明你遇到的問題。

    您可以複製並貼上收到的確切錯誤訊息、使用自然語言說明遇到的問題，或同時提供這兩項資訊。

  4. 選取要調查問題的開始時間。

  5. (選用) 選取您調查問題的結束時間。

  6. 如果您的進入點支援應用程式調查，請使用「應用程式」欄位選擇要調查的應用程式。

    • 如果進入點不支援應用程式調查，系統會將目前的專案列為「目標專案」，且無法變更。

  7. (選用) 按一下「+ 新增資源」，選取受您所遇問題影響的資源。

    你可以使用資源挑選器新增資源，也可以手動輸入資源。手動輸入資源時，請參閱資源的參考文件，確保格式正確。

    如果包含下列任何內容，您就無法繼續調查：

    • 調查範圍外的專案或應用程式中的資源。
    • 不支援的資源。
    • 無法辨識的資源。

  8. 按一下「建立」即可開始調查。

調查作業最多可能需要幾分鐘才能完成。如要查看調查狀態，請按一下「通知」按鈕 ()。

API

  1. 建立包含下列資訊的 JSON 檔案：

    {
"title": "INVESTIGATION_NAME",
"observations": {
  "user.project": {
    "id": "user.project",
    "observationType": "OBSERVATION_TYPE_STRUCTURED_INPUT",
    "observerType": "OBSERVER_TYPE_USER",
    "text": "PROJECT_NAME"
  },
  "user.input.text": {
    "id": "user.input.text",
    "observationType": "OBSERVATION_TYPE_TEXT_DESCRIPTION",
    "observerType": "OBSERVER_TYPE_USER",
    "timeIntervals": [
      {
        "startTime": "ISSUE_START_TIME"
      }
    ],
    "text": "ISSUE_DESCRIPTION",
    "relevantResources": [
      "AFFECTED_RESOURCE"
    ],
  },
}

    更改下列內容：

    • INVESTIGATION_NAME：輸入調查名稱。例如 Missing Cloud Storage bucket。

    • PROJECT_NAME：輸入要建立調查的專案名稱。例如：my-project。

    • ISSUE_START_TIME：輸入您要調查的問題開始發生的日期和時間。例如：2025-07-08T17:23:00Z。

    • ISSUE_DESCRIPTION：輸入問題說明。你可以提供收到的錯誤訊息全文、使用自然語言說明遇到的問題，或同時提供兩者。

    • AFFECTED_RESOURCE：輸入發生問題的資源名稱。例如：//storage.googleapis.com/my-bucket。如要確保資源格式正確，請參閱資源的參考說明文件。

    如要完整呈現調查資源，請參閱資源規格。

  2. 取得存取權杖：

    TOKEN=$(gcloud auth print-access-token)

  3. 使用 investigations.create 方法建立調查：

    curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  "https://geminicloudassist.googleapis.com/v1alpha/projects/PROJECT_NAME/locations/global/investigations"

    更改下列內容：

    • JSON_FILE_NAME：輸入您先前建立的 JSON 檔案路徑。例如：Desktop/my-investigation.json。

    • PROJECT_NAME：輸入您在 user.project 觀察項目中加入的專案名稱。

  4. 在回應中，複製 revision 參數中的值。

  5. 使用 investigations.revisions.run 方法執行調查：

    curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  "https://geminicloudassist.googleapis.com/v1alpha/projects/REVISION_RESOURCE:run"

    將 REVISION_RESOURCE 替換為您從 revision 參數複製的值。

調查作業最多可能需要幾分鐘才能完成。如要查看調查狀態，請複製 investigations.revisions.run 回應中傳回的 name 參數值，並在 operations.get 要求的 name 參數中使用該值。

查看調查

調查完成後，您可以從啟動調查的進入點，或從專案的調查記錄查看調查詳細資料。

調查包含下列各節：

  1. 問題

    這個部分包含用於生成調查結果的輸入資訊，例如問題說明、時間戳記和相關資源清單。調查可能與三種資源清單相關聯：

    • 使用者提供的資源：使用者提供的資源，或從初始錯誤擷取的資源。
    • 發現的資源：Gemini 在執行調查時考量的其他資源。
    • 相關資源：Gemini 認為與根本原因假設相關的資源，一律包含使用者提供的資源。

  2. 觀察項目

    這個部分包含調查產生的觀察結果。 觀察結果是根據程序手冊、記錄、中斷訊息和快訊的審查結果而定。根據這些觀察結果，Gemini 會生成假設，指出您正在調查的問題根本原因。

  3. 假設

    這個部分包含一或多個假設，這些假設是根據調查收集的資料和觀察結果而來。假設包含問題的總覽，以及建議的修正方式，也就是可協助您修正問題的動作，或提供額外的疑難排解步驟，以確認或駁斥假設。

您可以點選「編輯」按鈕修改調查輸入內容，然後使用更新後的資訊重新執行調查。如果調查與多個執行作業相關聯，您可以使用「修訂版本」下拉式選取器，查看先前執行調查的結果。

後續步驟