为 Gemini Cloud Assist 配置接地

本文档介绍了如何使用 Google Cloud 控制台或 API 为 Gemini Cloud Assist 配置 接地。接地由 Vertex AI 提供。

可用的接地类型：

• 依托 Google 搜索进行接地（推荐）： 指示 Gemini Cloud Assist 使用 Google 搜索来获取最 全面、最新的回答。请注意，此选项不支持数据驻留、Access Transparency 和客户管理的加密密钥 (CMEK) 等特定产品。

• 适用于企业的 Web 接地: 利用一部分 Web 内容。虽然与依托 Google 搜索进行接地相比，这可能会导致回答质量降低，但对于需要严格遵守数据驻留合规性要求的受严格监管的行业（例如金融、医疗保健和公共部门），这是首选选项。

默认情况下，Gemini Cloud Assist 使用依托 Google 搜索进行接地来提高其对提示的回答质量。使用 Google 搜索接地涉及对提示和回答进行特殊数据处理，如 Google Cloud 服务条款中所述。

准备工作

1. 验证您的 Google Cloud 项目是否已关联结算账号。

2. 验证已为您的 Google Cloud 项目设置了 Gemini Cloud Assist。

3. 如需获得为 Gemini Cloud Assist 配置接地所需的权限，请让管理员向您 授予项目的 Gemini for Google Cloud 设置管理员 (roles/cloudaicompanion.settingsAdmin) Identity and Access Management (IAM) 角色。此预定义角色包含管理 Gemini Cloud Assist 管理员设置所需的权限。

   如需查看所需的确切权限，请展开所需权限 部分：

   所需权限

   • cloudaicompanion.geminiGcpEnablementSettings.create
   • cloudaicompanion.geminiGcpEnablementSettings.update
   • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsCreate
   • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUse
     • 如果您使用的是直接 API 请求，则需要此权限，尤其是针对 TARGET_PROJECT。

   如果您 使用的是 Google Cloud 控制台，则还需要以下权限：

   • cloudaicompanion.instances.queryEffectiveSetting
   • cloudaicompanion.instances.queryEffectiveSettingBindings
   • cloudaicompanion.geminiGcpEnablementSettings.get
   • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
   • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUpdate

您可以使用其他 预定义角色或 自定义角色来获取这些权限。

为 Gemini Cloud Assist 配置接地

从下列选项中选择一项：

控制台

1. 打开 Google Cloud 控制台。

   前往 Google Cloud 控制台

2. 在 Google Cloud 控制台的任意页面中，点击 星光图标 打开或关闭 Gemini Cloud Assist 对话。

   系统将打开 Cloud Assist 面板。

3. 点击更多操作 ()， 然后从下拉菜单中点击 Cloud Assist 设置 。

   系统将打开管理 Gemini Cloud Assist 设置面板。

4. 选择要使用的接地选项。

5. 点击保存 。

API

如需使用 API 为 Gemini Cloud Assist 配置接地，请创建 一个 geminiGcpEnablementSettings 资源，该资源定义接地类型， 使用 geminiGcpEnablementSettings.create 方法。然后，使用关联的 settingBindings.create 方法应用该设置，将该设置绑定到项目。

1. 设置项及其专用值：

   1. 获取身份验证令牌：

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

      如需详细了解身份验证，请参阅 使用 REST 时进行身份验证。

   2. 运行以下命令以创建设置：

      curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "webGroundingType": "GROUNDING_TYPE"
          }' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"
      

      替换以下内容：

      • CONTAINER_PROJECT：存储设置数据的项目的项目 ID。
      • GROUNDING_TYPE：接地类型，即 GROUNDING_WITH_GOOGLE_SEARCH 或 WEB_GROUNDING_FOR_ENTERPRISE。
      • GROUNDING_SETTING_ID：用于标识此特定设置数据的唯一名称，例如 gt1。

      如果命令成功，则会返回一个响应正文，其中显示 webGroundingType 设置为您的选择：

      {
        "name": "projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "webGroundingType": "GROUNDING_TYPE"
      }
      

2. 创建设置绑定：

     curl -X POST \
       -H "Authorization: Bearer $TOKEN" \
       -H 'Content-Type: application/json' \
       -d '{
         "target": "projects/TARGET_PROJECT",
         "product": "GEMINI_CLOUD_ASSIST"
         }' \
       "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings?settingBindingId=GROUNDING_BINDING_ID"
   

   替换以下内容：

   • TARGET_PROJECT：应应用该设置的项目的项目 ID。通常，目标项目和容器项目是相同的。
   • CONTAINER_PROJECT：存储设置数据的项目的项目 ID。
   • GROUNDING_SETTING_ID：您在创建设置时指定的 GROUNDING_SETTING_ID。
   • GROUNDING_BINDING_ID：用于标识此特定设置绑定资源的唯一 ID，例如 b1。

   如果命令成功，则会采用以下格式返回操作元数据：

   {
     "name": "projects/CONTAINER_PROJECT/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
       "createTime": "2025-01-23T15:27:50.076075570Z",
       "target": "projects/TARGET_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings/GROUNDING_BINDING_ID",
       "verb": "create",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }
   

后续步骤

• 查看其他 Gemini Cloud Assist 管理员设置。