设置 Google 云端硬盘数据存储区

本页面介绍了如何创建数据存储区并将 Google 云端硬盘关联到 Gemini Enterprise。关联后，Gemini Enterprise 即可直接从 Google 云端硬盘检索信息。由于数据不会复制到 Gemini Enterprise 索引中，您无需管理数据存储区。

准备工作

  • 您必须使用计划关联的 Google 云端硬盘实例所用的同一账号登录 Google Cloud 控制台。Gemini Enterprise 会使用您的 Google Workspace 客户 ID 关联到 Google 云端硬盘。个人 Google 账号（以 @gmail.com 结尾的消费者账号）没有客户 ID，因此不受支持。

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

  • 验证所有文档是否都可访问，方法是将它们放在网域拥有的共享云端硬盘中，或将所有权分配给网域中的用户。

  • 启用智能功能：在您的 Google Workspace 账号中，同时开启 Google Workspace 中的智能功能和其他 Google Google 产品中的智能功能。如需了解详情，请参阅启用或停用 Google Workspace 智能功能。

  • 将 OAuth 应用列入许可清单（仅限管理员）：Google 云端硬盘数据存储区使用 Google管理的 OAuth 应用来访问您的数据。如果贵组织限制 OAuth 应用访问权限，您的 Google Workspace 管理员必须将此应用添加到贵组织的许可清单中。如需了解详情，请参阅将 Google管理的 OAuth 应用列入许可清单。

创建 Google 云端硬盘数据存储区

如需创建 Google 云端硬盘数据存储区，请执行以下步骤：

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

    Gemini Enterprise

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

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

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

  5. 在来源部分中，搜索 Google 云端硬盘，然后点击选择。

  6. 可选：在数据部分中，配置过滤条件，以限定数据存储区搜索的 Google 云端硬盘内容范围。如需使用 Google Cloud 控制台或 REST API 配置过滤条件，请选择以下选项之一：

    控制台

    1. 在共享云端硬盘 ID 字段和/或文件夹 ID 字段中，输入要作为过滤条件的 ID。
    2. 对于每个字段，选择包含以仅搜索指定的 ID，或选择排除以在搜索中忽略这些 ID。为每个字段配置包含模式或排除模式，但不能同时配置这两种模式。
    3. 如需查找文件夹 ID 或共享云端硬盘 ID，请在 Google 云端硬盘中打开相应文件夹或共享云端硬盘，然后从网址中复制 ID。网址采用以下格式：https://drive.google.com/drive/folders/ID。 例如 https://drive.google.com/drive/folders/123456789012345678901。

    REST API

    如需创建包含过滤条件的数据存储区，请调用 setUpDataConnector 方法。

    包含列表在 admin_filter 下设置，排除列表在 admin_exclusion_filter 下设置。对于每种过滤条件类型，请填充 admin_filter 下或 admin_exclusion_filter 下的列表，但不能同时填充两者。

       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_drive",
         "params": {
           "FILTER_TYPE": {
             "FILTER_KEY": [
               "FILTER_VALUE_1",
               "FILTER_VALUE_2"
             ]
           }
         },
         "entities": [
           {
             "entityName": "google_drive"
           }
         ],
         "connectorModes": [
           "FEDERATED"
         ]
       }
   }'

    替换以下内容：

    • PROJECT_ID：您的项目的 ID。
    • ENDPOINT_LOCATION：API 请求的多区域。请指定以下某个值：
      • us（表示美国多区域）
      • eu（表示欧盟多区域）
      • global（表示全球位置）
      如需了解详情，请参阅为数据存储区指定多区域。
    • LOCATION：数据存储区的多区域：global 或 us。
    • COLLECTION_ID：数据存储区的唯一 ID。
    • COLLECTION_DISPLAY_NAME：数据存储区的显示名称。
    • FILTER_TYPE：过滤条件的类型，admin_filter 表示包含，admin_exclusion_filter 表示排除。在 admin_filter 或 admin_exclusion_filter 下填充列表，但不能同时在两者下填充。
    • FILTER_KEY：要过滤的云端硬盘实体，即 SharedDriveIds 或 FolderIds。
    • FILTER_VALUE_1、FILTER_VALUE_2：要过滤的共享云端硬盘 ID 或文件夹 ID。

  7. 在操作部分，从列表中选择相应操作，以针对 Google 云端硬盘连接器启用这些操作。

    如需管理操作列表，请参阅管理操作。

  8. 点击继续。

  9. 在配置部分中：

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

  10. 可选：在标记字段中，输入数据存储区的稳定标识符。此标识符在连接器的不同版本中通用，并且在创建数据存储区后便无法更改，因此请选择一个日后无需更改的值。

  11. 可选：在敏感数据保护政策部分中，附加现有的 Sensitive Data Protection 政策，以检查和去标识化 Gemini Enterprise 通过此数据存储区检索的数据。如果贵组织不需要 Sensitive Data Protection 政策，您可以跳过此步骤。

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

如需验证数据存储区的状态，请执行以下操作：

  1. 在数据存储区列表中找到相应连接器，并监控其状态，直到该状态变为活跃。
  2. 在数据存储区状态从正在创建更改为活跃时，Google 云端硬盘连接器即可供使用。

创建数据存储区后，创建应用并将其关联到 Google 云端硬盘数据存储区，然后再执行查询。

查询执行

在授权 Google 云端硬盘后，如果您输入搜索查询：

  1. Gemini Enterprise 会将您的搜索查询发送给 Google Drive API。

  2. Gemini Enterprise 会将获得的结果与其他来源的结果融合，然后显示出来。

错误消息和问题排查

下表介绍了使用此 Google 数据源时可能会遇到的错误消息，包括 HTTP 错误代码和建议的问题排查步骤。

错误代码 出错提示 说明 问题排查
403 权限遭拒 Google Workspace 数据存储区不支持通过服务账号凭证进行搜索。 被搜索的引擎包含 Google Workspace 数据存储区，且传递的为服务账号凭证。不支持使用服务账号凭证搜索 Google Workspace 数据存储区。 使用用户凭证调用搜索，或从该引擎中移除 Google Workspace 数据存储区。
403 权限遭拒 Google Workspace 数据存储区不支持个人账号。 调用搜索时使用了个人账号 (@gmail.com) 凭证，而 Google Workspace 数据存储区不支持该类凭证。 从该引擎中移除 Google Workspace 数据存储区，或使用受管理的 Google 账号。
403 权限遭拒 数据存储区的客户 ID 不匹配 只有与 Google Workspace 数据存储区属于同一组织的用户才能进行搜索。 从该引擎中移除 Google Workspace 数据存储区，或在用户与数据存储区确实属于不同组织时联系支持团队。
403 权限遭拒 组织管理员已停用 Agentspace 对 Workspace 的访问权限。 Google Workspace 管理员已禁止 Gemini Enterprise 访问 Google Workspace 数据。 请与您的 Google Workspace 管理员联系，以启用访问权限。
400 参数无效 请求中包含无效的参数。 如果请求中的数据连接器名称不符合命名要求，就会发生此错误。验证数据连接器名称，确保其长度为 1 到 63 个字符，以小写字母开头，以小写字母或数字结尾，并且仅包含小写字母、数字、连字符或下划线。例如，使用 cymbal-collection-123456789 而不是 123456789-cymbal-collection。

如需了解在查询 Google 云端硬盘数据时遇到的常见搜索问题，请参阅常见搜索问题。

后续步骤