设置 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 Workspace 智能 功能。

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

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

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

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

    Gemini Enterprise

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

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

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

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

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

    控制台

    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 政策 部分中，附加现有的 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 云端硬盘数据时遇到的常见搜索问题，请参阅常见搜索问题。

后续步骤