设置 Gemini Cloud Assist

控制台

1. 前往 Gemini 管理中心页面。

   前往 Gemini for Google Cloud

2. 从页面顶部的项目选择器中，选择您的项目资源。

3. 选择获取 Gemini Cloud Assist。

4. 在 Get Gemini Cloud Assist 对话框中，执行以下操作：

   1. 选择 expand_more 展开 箭头，该箭头位于 必需的 API 和推荐的 API 部分中。

   2. 在推荐的 API 列表中，选择要启用的任何其他 API，以提高 Gemini Cloud Assist 的性能。

   3. 可选：选择通过共享提示和回答，帮助 Google 改进 Cloud Assist 。

   4. 选择免费启用 Gemini Cloud Assist。

5. 点击保存 。

6. 授予使用 Gemini Cloud Assist 所需的 IAM 角色。

   1. 前往 IAM 和管理 页面。

      前往 IAM 和管理

   2. 在 主账号 列中，找到要向其授予 Gemini Cloud Assist 访问权限的 主账号，然后在对应的 行中点击 edit 修改主账号。

   3. 在编辑权限 窗格中，点击 add 添加其他角色。

   4. 在选择角色 中，选择 Gemini Cloud Assist User。

   5. 点击添加其他角色 ，然后选择 Cloud Asset Viewer 。

   6. 如果正文希望获得自己尚未获得访问权限的产品的相关帮助，您可能需要向其授予其他 IAM 角色，方法是点击添加其他角色 并选择其他角色。如需查看可为不同产品提供最佳 Gemini Cloud Assist 体验的 IAM 角色表格，请参阅使用 Gemini Cloud Assist 的 IAM 要求。

   7. 如果您的项目属于使用 自定义限制条件的组织， 请查看聊天所需的权限 ，确保 Gemini Cloud Assist 聊天不会被屏蔽。

7. （可选）为项目配置设置。

gcloud

1. 在 Google Cloud 控制台中，激活 Cloud Shell。

   激活 Cloud Shell

2. 使用 gcloud services enable 命令启用 Gemini Cloud Assist API：

   gcloud services enable geminicloudassist.googleapis.com
   

   此步骤还会启用 Gemini for Google Cloud API，该 API 也是使用 Gemini Cloud Assist 所必需的。

   如要在其他 Google Cloud 项目中启用 Gemini Cloud Assist API，请添加 --project 参数：

   gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID
   

   将 PROJECT_ID 替换为您要为其启用 Gemini Cloud Assist 的项目的 ID。

   输出类似于以下内容：

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

3. 使用 `gcloud services enable` 命令启用其他必需的 API，就像启用 Gemini Cloud Assist API 一样：gcloud services enable

   gcloud services enable cloudasset.googleapis.com designcenter.googleapis.com appoptimize.googleapis.com apphub.googleapis.com --project PROJECT_ID
   

4. （可选）使用 gcloud services enable 命令启用推荐的 API ，就像启用 Gemini Cloud Assist API 一样。

5. 在 Google Cloud 项目中授予 IAM 角色。如需了解详情，请参阅授予单个角色和　gcloud projects add-iam-policy-binding。

   1. 授予 roles/geminicloudassist.user 角色：

      gcloud projects add-iam-policy-binding PROJECT_ID \
        --member=PRINCIPAL --role=roles/geminicloudassist.user
      

      替换以下内容：

      • PROJECT_ID：您的Google Cloud 项目的 ID，例如 1234567890。
      • PRINCIPAL：主账号的标识符，例如 user:cloudysanfrancisco@gmail.com。

      输出是一个政策绑定列表，其中包含以下内容：

      - members:
        - user:PRINCIPAL
        role: roles/geminicloudassist.user
      

   2. 对角色 roles/cloudasset.viewer 重复上一步。

   3. 如果主账号希望获得自己尚未获得访问权限的产品的相关帮助，您可能需要向其授予其他 IAM 角色。如需查看可为不同产品提供最佳 Gemini Cloud Assist 体验的 IAM 角色表格，请参阅使用 Gemini Cloud Assist 的 IAM 要求。

   4. 如果您的项目属于使用 自定义限制条件的组织， 请查看聊天所需的权限 ，确保 Gemini Cloud Assist 聊天不会被屏蔽。

6. （可选）为项目配置设置。

API

这些说明使用 cURL 调用 API 方法。

1. 使用 services.enable 方法启用 Gemini Cloud Assist API：

   curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/geminicloudassist.googleapis.com:enable"
   

   将 PROJECT_ID 替换为您要为其启用 Gemini Cloud Assist 的项目的 ID。

   如果命令成功，它会返回一个 long-running operation， 其中包含一个 name 字段。您可以使用 name 字段 来 检查操作的状态。

2. 使用 services.enable 方法 启用以下 其他必需的 API ，就像启用 Gemini Cloud Assist API 一样：

   • cloudasset.googleapis.com
   • designcenter.googleapis.com
   • appoptimize.googleapis.com
   • apphub.googleapis.com

3. （可选）使用 services.enable 方法启用推荐的 API ，就像启用 Gemini Cloud Assist API 一样。

4. 为关联的 Google Cloud 项目授予 IAM 角色。

   1. 创建一个包含以下信息的 JSON 文件：

        {
          "options": {
            "requestedPolicyVersion": 3
          }
        }
      

   2. 使用 projects.getIamPolicy方法检索项目的现有 IAM 政策：

        curl -X POST --data-binary @JSON_FILE_NAME \
          -H "Authorization: Bearer $(gcloud auth print-access-token)" \
          -H "Content-Type: application/json" \
          "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy"
      

      替换以下内容：

      • JSON_FILE_NAME：您在上一步中创建的 JSON 文件的路径。

      • PROJECT_ID：项目的 ID。

      如果成功，响应会返回项目的 IAM 政策。

   3. 将项目的 IAM 政策复制到空 JSON 文件，并将以下信息添加到现有内容：

        {
          "role": "roles/geminicloudassist.user",
          "members": [
            "PRINCIPAL"
          ]
        },
        {
          "role": "roles/cloudasset.viewer",
          "members": [
            "PRINCIPAL"
          ]
        }
      

      将 PRINCIPAL 替换为您要向其授予 Gemini Cloud Assist 访问权限的主账号的标识符。

   4. 使用 projects.setIamPolicy方法将更新后的 IAM 政策应用于项目：

        curl -X POST --data-binary @JSON_FILE_NAME \
          -H "Authorization: Bearer $(gcloud auth print-access-token)" \
          -H "Content-Type: application/json" \
          "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy"
      

      替换以下内容：

      • JSON_FILE_NAME：您在上一步中创建的 JSON 文件的路径。

      • PROJECT_ID：项目的 ID。

      如果成功，响应会返回项目的更新后 IAM 政策。

   5. 如果主账号希望获得自己尚未获得访问权限的产品的相关帮助，您可能需要向其授予其他 IAM 角色。如需查看可为不同产品提供最佳 Gemini Cloud Assist 体验的 IAM 角色表格，请参阅使用 Gemini Cloud Assist 的 IAM 要求。

   6. 如果您的项目属于使用 自定义限制条件的组织， 请查看聊天所需的权限 ，确保 Gemini Cloud Assist 聊天不会被屏蔽。

5. （可选）为项目配置设置。