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

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

准备工作

如需在创建数据存储区之前准备 Google 云端硬盘环境，请执行以下操作：

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

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

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

  • 在 Google Workspace 中启用 Gemini Enterprise 访问权限：在Google 管理控制台中，用户和 Google 云端硬盘数据驻留所在组织的 Google Workspace 管理员必须开启允许 Gemini Enterprise 访问 Google Workspace 数据。如果此设置处于关闭状态，Google 云端硬盘搜索不会在 Gemini Enterprise Web 应用中返回结果（并且可能会在 API 中返回 403 Permission Denied: Workspace access for Agentspace disabled by organization admin. 错误）。如需查看相关说明，请参阅控制 Gemini Enterprise 对 Google Workspace 数据的访问权限。

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

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

  • 配置跨组织访问权限（如果适用）：默认情况下，只有当用户的 Google Workspace 客户 ID 与 Google 云端硬盘数据存储区和 Google Cloud 项目的组织匹配时，Gemini Enterprise 才允许用户搜索 Google 云端硬盘数据存储区。如果您的用户或 Google 云端硬盘数据属于其他 Google Workspace 组织（例如，当您的 Google Cloud 项目位于一个网域中，而用户从一个或多个单独的 Google Workspace 网域或测试租户登录时），请完成以下步骤：

    1. 请与 Cloud Customer Care 联系，将每个用户 Google Workspace 组织的客户 ID（例如 C01234567）添加到 Google Cloud 项目的许可清单中。
    2. 让每个 Google Workspace 组织中的 Google Workspace 管理员在该组织的 Google 管理控制台中启用允许 Gemini Enterprise 访问 Google Workspace 数据。仅在 Google Cloud 项目的组织中启用此设置是不够的。如需了解详情，请参阅控制 Gemini Enterprise 对 Google Workspace 数据的访问权限。

    此外，如果用户需要查找其所在组织外部拥有的文档，请为您的应用启用包含跨网域文档。您可以在创建应用时选择此选项，也可以稍后在管理 Web 应用功能中启用此选项。

创建 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 政策部分，附加现有的 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 客户 ID 与 Google Workspace 数据存储区和 Google Cloud 项目所属组织匹配的用户才能进行搜索，除非用户的 Google Workspace 客户 ID 位于项目的许可清单中。 如果这种不一致并非有意为之，请在 Google Cloud 与 Google Workspace 用户属于同一组织的项目中重新创建数据存储区，或从应用中移除 Google Workspace 数据存储区。如果用户和 Google Workspace 数据存储区确实属于不同组织，请联系 Cloud Customer Care，将每个用户的 Google Workspace 客户 ID 添加到 Google Cloud 项目的许可清单中，并确保每个用户组织的 Google Workspace 管理员启用 Gemini Enterprise 对 Google Workspace 数据的访问权限。 此外，如果用户需要查找其组织外部拥有的文档，请在管理 Web 应用功能中启用包含跨网域文档。
403 权限遭拒 组织管理员已停用 Agentspace 对 Workspace 的访问权限。 用户所在 Google Workspace 组织的 Google Workspace 管理员已禁止 Gemini Enterprise 访问 Google Workspace 数据。在 Gemini Enterprise Web 应用中，此错误可能不会直接显示，而是查询返回没有匹配的 Google 云端硬盘文件。 请与用户所属 Google Workspace 组织的 Google Workspace 管理员联系，以启用访问权限。在跨组织设置中，必须在每个 Google Workspace 组织的 Google 管理控制台中启用此设置，其用户才能查询 Google 云端硬盘。
400 参数无效 请求中包含无效的参数。 如果请求中的数据连接器名称不符合命名要求，就会发生此错误。验证数据连接器名称，确保其长度为 1 到 63 个字符，以小写字母开头，以小写字母或数字结尾，并且仅包含小写字母、数字、连字符或下划线。例如，使用 cymbal-collection-123456789 而不是 123456789-cymbal-collection。

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

后续步骤