创建 Cloud Assist 调查

本页面介绍了如何创建和查看 Gemini Cloud Assist 调查。

准备工作

验证您的项目是否已启用以下 API：
- cloudaicompanion.googleapis.com
- cloudasset.googleapis.com
- cloudresourcemanager.googleapis.com
- geminicloudassist.googleapis.com
- （推荐）logging.googleapis.com
- （推荐）monitoring.googelapis.com
如需了解如何启用 API，请参阅启用和停用服务。
如需获得创建调查所需的权限，请让您的管理员向您授予项目的 Investigation Creator (roles/geminicloudassist.investigationCreator) IAM 角色。

此预定义角色包含在项目中创建调查所需的权限。创建调查后，您将获得该调查的 Investigation Owner (roles/geminicloudassist.investigationOwner) IAM 角色，从而可以查看调查结果。
有权访问正在调查的产品。

当您执行调查时，Gemini Cloud Assist 会使用您的凭证来访问 API 及相关信息。这意味着，调查的访问权限取决于您所拥有的访问权限。
如果您打算对应用执行调查，则相应应用必须包含在已启用应用的文件夹中。

创建调查

控制台

如需创建新的调查，请点击与相应入口点关联的调查按钮。创建调查的一个典型入口点是 Cloud Assist 调查页面。

前往“Cloud Assist 调查”
（可选）为调查输入一个名称。

您输入的名称将用于在调查历史记录中标识相应调查。如果您跳过此步骤，系统会自动生成调查的名称。
描述您遇到的问题。

您可以复制并粘贴收到的确切错误消息，也可以使用自然语言说明您遇到的问题，或者同时通过这两种方式提供相关信息。
选择要开始调查问题的时间，即开始时间。

注意：设置准确的开始时间有助于在看似无关的事件之间建立基于时间的关联，并为在开始时间前后发生的事件赋予更高的权重。如果您不确定开始时间，可以同时运行多个调查，并设置不同的开始时间。
（可选）选择所调查的问题结束的时间，即结束时间。
如果入口点支持应用调查，请使用应用字段选择要调查的应用。
- 对于不支持应用调查的入口点，您的当前项目会列为目标项目，并且无法更改。
（可选）点击 + 添加资源，选择受您遇到的问题影响的资源。

您可以使用资源选择器添加资源，也可以手动输入资源。手动输入资源时，您应查阅资源的相关参考文档，以确保使用正确的格式。

如果您包含以下任何内容，则无法继续进行调查：
- 处于调查范围之外的项目或应用中的资源。
- 不受支持的资源。
- 无法识别的资源。
点击创建以开始调查。

调查可能需要几分钟时间才能完成。您可以点击通知按钮 () 来查看调查状态。

API

创建一个包含以下信息的 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。为确保您使用正确的资源格式，您应查阅资源的相关参考文档。
如需查看调查资源的完整表示形式，请参阅资源规范。
获取访问令牌：
```
TOKEN=$(gcloud auth print-access-token)
```
使用 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 观察中包含的同一项目名称。
在响应中，复制 revision 参数中的值。

使用 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 参数中使用该值，以查看调查状态。

查看调查

调查完成后，您可以从发起调查的入口点或项目的调查历史记录中查看调查详情。

调查包含以下部分：

问题

此部分包含用于生成调查结果的输入信息，例如问题描述、时间戳及相关资源列表。可能有三种类型的资源列表与调查相关联：
- 用户提供的资源：用户提供的资源或从初始错误中提取的资源。
- 发现的资源：Gemini 在执行调查时考虑的其他资源。
- 相关资源：Gemini 认为与根本原因假设相关的资源，始终包括用户提供的资源。
观察结果

此部分包含调查生成的观察结果。观察结果基于对程序化 runbook、日志、服务中断消息及提醒的审核。根据这些观察结果，Gemini 会生成有关您正在调查问题的根本原因的假设。
假设

此部分包含一个或多个假设，这些假设基于调查收集的数据及观察结果。假设包含潜在问题概览，以及推荐的修复措施，这些措施可帮助您纠正问题，或为您提供其他问题排查步骤来确认或反驳假设。

您可以使用修改按钮修订调查输入内容，以便使用更新后的信息重新运行调查。如果某项调查关联了多次运行，您可以使用修订版本下拉选择器查看之前调查运行的结果。

后续步骤

详细了解调查。
查看和管理现有调查。