设置 Google Chat 数据存储区

本页面介绍了如何创建数据存储区并将 Google Chat 关联到 Gemini Enterprise。

准备工作

  • 使用与您要关联的 Google Workspace 实例关联的同一账号登录 Google Cloud 控制台。 Gemini Enterprise 会使用您的 Google Workspace 客户 ID 关联到 Google Chat。

  • 如需在 Gemini Enterprise 中强制执行数据源访问权限控制并保护数据安全，请确保您已 配置身份提供方。

创建 Google Chat 数据存储区

如需创建 Google Chat 数据存储区，请执行以下步骤：

  1. 在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

    Gemini Enterprise

  2. 选择或创建 Google Cloud 项目。

  3. 在导航菜单中，点击数据存储区。

  4. 点击 + 创建数据存储区 。

  5. 在来源 中，搜索 Google Chat ，然后点击选择 。

  6. 在数据 部分中，配置过滤条件以管理已编入索引的聊天数据的量、相关性和隐私。 您可以使用 Google Cloud 控制台或 API 向数据存储区添加过滤条件：

    控制台

    1. 在消息新近度过滤条件 字段中，输入要为搜索结果编入索引的聊天记录天数。例如，输入 90 可确保仅搜索最近 90 天内的消息，过滤掉较旧且相关性较低的数据。
    2. 选中排除私信 复选框，以从搜索结果中排除所有私密的一对一私信。启用后，Google Chat 连接器只会为多用户聊天室和群组聊天编入索引。

    REST

    如需在创建数据存储区时添加过滤条件，请调用 setUpDataConnector 方法。

    

    curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -H "X-Goog-User-Project: PROJECT_ID" \
      "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
      -d '{
        "collectionId":"COLLECTION_ID",
        "collectionDisplayName":"COLLECTION_DISPLAY_NAME",
        "dataConnector":{
          "dataSource":"google_chat",
          "params":{
            "admin_filter":{
              "MessageRecency":RECENCY_DAYS,
              "ExcludeDirectMessages":EXCLUDE_DMS
              }
            },
          "entities":[
            {
              "entityName":"google_chat"
            }],
            "connectorModes":[
              "FEDERATED"
              ]
        }
      }'

    替换以下内容：

    • PROJECT_ID：项目的 ID。
    • ENDPOINT_LOCATION：API 请求的多区域。请指定以下某个值：
      • us（表示美国多区域）
      • eu（表示欧盟多区域）
      • global（表示全球位置）
      如需了解详情，请参阅 指定多区域 为数据存储区。
    • LOCATION：数据存储区的多区域： global、us 或 eu
    • COLLECTION_ID：数据存储区的唯一 ID。
    • COLLECTION_DISPLAY_NAME：数据存储区的显示名称。
    • EXCLUDE_DMS：布尔值（true 或 false）。
    • RECENCY_DAYS：表示消息存在时间上限的整数。例如，90。

    如需详细了解过滤条件类型和添加过滤条件，请参阅向 Google Chat 数据存储区添加过滤条件。

  7. 点击继续 。

  8. 在配置 部分中：

    1. 从多区域列表中，选择数据连接器的位置。
    2. 在数据连接器名称字段中，为连接器输入名称。
    3. 如果您选择 us 或 eu 作为位置，请配置加密设置：
      • 选择 Google管理的加密密钥或 Cloud KMS 密钥。
      • 如果您选择的是 Cloud KMS 密钥：
        • 在密钥管理类型列表中，选择适当的类型。
        • 在 Cloud KMS 密钥列表中，选择相应密钥。
      如需了解详情，请参阅客户管理的加密密钥。

  9. 点击继续。

  10. 在结算部分中，选择一般价格或可配置的价格。如需了解详情，请参阅验证项目的结算状态和许可。

  11. 点击创建。Gemini Enterprise 会为您创建数据存储区，并在数据存储区页面上显示您的数据存储区。

在数据存储区 页面上，点击数据存储区名称以查看状态。在数据存储区状态从正在创建更改为活跃时，Google Chat 连接器即可供使用。

创建数据存储区后，将刚刚创建的数据存储区关联到现有应用，或创建新应用并将其关联到新应用，然后在执行任何查询之前授权 Gemini Enterprise 访问 Google Chat。

查询执行

本部分介绍了 Gemini Enterprise 如何管理您的查询，以及使用联合数据存储区所涉及的隐私权问题。

在您授权 Google Chat 并向 Gemini Enterprise 发送搜索查询后：

  • Gemini Enterprise 会将您的搜索查询直接发送给 Google Chat API。
  • Gemini Enterprise 会将获得的结果与其他关联数据源的结果融合，然后显示全面的搜索结果。

错误消息和问题排查

下表介绍了使用 Google Chat 连接器时可能会遇到的常见错误消息，包括可能的 HTTP 错误代码和建议的问题排查步骤。

错误代码 错误消息 说明 问题排查
403 (Permission Denied) Google Workspace 数据存储区不支持使用服务账号凭证进行搜索。 被搜索的引擎包含 Google Workspace 数据存储区，且传递的为服务账号凭证。不支持使用服务账号凭证搜索 Google Workspace 数据存储区。 使用用户凭证调用搜索，或从该引擎中移除 Google Workspace 数据存储区。
403 (Permission Denied) Google Workspace 数据存储区不支持个人账号。 调用搜索时使用了个人账号 (@gmail.com) 凭证，而 Google Workspace 数据存储区不支持该类凭证。 从该引擎中移除 Google Workspace 数据存储区，或使用受管理的 Google 账号。
403 (Permission Denied) 数据存储区的客户 ID 不匹配 只有与 Google Workspace 数据存储区属于同一组织的用户才能进行搜索。 从该引擎中移除 Google Workspace 数据存储区，或在用户与数据存储区确实属于不同组织时联系支持团队。
403 (Permission Denied) 组织管理员已停用 Agent Space 对 Workspace 的访问权限。 Google Workspace 管理员已禁止 Gemini Enterprise 访问 Google Workspace 数据。 请与您的 Google Workspace 管理员联系，以启用访问权限。

后续步骤