为 Gemini Cloud Assist 配置接地

借助连接功能，您可以通过 Vertex AI 将 Gemini Cloud Assist 连接到外部网络来源，从而获得更准确、更及时的回答。本文档介绍了如何在 Google Cloud 控制台中或使用 API 配置事实依据。

可用的依据类型：

• 依托 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 Settings Admin (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.create 方法创建定义事实依据类型的 geminiGcpEnablementSettings 资源。然后，您可以使用关联的 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 管理员设置。