设置 Zendesk 数据存储区

公开预览版：联合搜索目前处于公开预览版阶段。此功能受《服务专用条款》的“通用服务条款”部分中的“非正式版产品条款”的约束。正式发布前功能“按原样”提供，可能只能获得有限的支持。如需了解详情，请参阅发布阶段说明。

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

准备工作

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

在设置 Zendesk 数据存储区之前，请确保满足以下条件：

1. 授予 Discovery Engine Editor 角色 (roles/discoveryengine.editor)。用户必须具有此角色才能创建数据存储区。如需授予此角色，请执行以下操作：

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

      进入 IAM

   2. 找到相应用户账号，然后点击修改 修改图标。
   3. 向用户授予 Discovery Engine Editor 角色。 如需了解详情，请参阅 IAM 角色和权限。

2. 创建 OAuth 客户端并获取以下凭据：

   • 客户端 ID

   • 客户端密钥

3. 在 Zendesk 中为 OAuth 应用配置必要权限。

4. 确保在 Zendesk API 设置中已启用令牌访问权限。

创建 Zendesk 数据存储区

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

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

   Gemini Enterprise

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

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

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

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

6. 在数据部分中：

   1. 在身份验证设置部分中，提供以下详细信息： * 实例 URI：输入 Zendesk 实例 URI（例如 https://[subdomain].zendesk.com）。 * 客户端 ID：在 Zendesk 中注册的应用的唯一标识符。 * 客户端密钥：在 Zendesk 中执行 OAuth 2.0 应用注册流程期间生成的密钥。

      如需了解如何获取客户端 ID 和客户端密钥，请参阅获取客户端 ID 和客户端密钥。如需了解执行搜索所需的权限，请参阅所需权限。

   2. 点击登录，然后完成 Zendesk 登录。

   3. 点击继续。

   4. 在目标部分中：

      1. 代理服务器：输入用于路由 HTTP 流量的代理的主机名或 IP 地址，包括主机和端口。
      2. Zendesk 支持网址：输入实例网址（包括 https://），即您的 Zendesk 支持网址。
      3. 点击继续。

   5. 可选：在高级选项部分中：

      1. 启用静态 IP 地址：注册一组狭义的静态 IP 地址，以添加到系统的许可名单中。在这些 IP 地址列入许可名单之前，同步运行将失败。
      2. 每分钟的 API 请求数上限：每次运行连接器时，每分钟向 Zendesk 实例发送的 API 请求数上限。
      3. 点击继续。

   6. 在要搜索的实体部分，从列表中选择要搜索的所有实体。您必须至少选择一个实体。

      注意： 为避免 search articles 和 search community posts 实体的 404 错误，请确保已启用 Zendesk 帮助中心。如需了解详情，请参阅启用和激活帮助中心。

7. 点击继续。

8. 在配置部分中：

   1. 从多区域列表中，选择数据连接器的位置。
   2. 在数据连接器名称字段中，为连接器输入名称。
   3. 如果您选择 US 或 EU 作为位置，请配置加密设置：
      • 可选：如果您尚未配置单区域密钥，请点击前往设置页面进行配置。如需了解详情，请参阅为第三方连接器注册单区域密钥。
      • 选择 Google管理的加密密钥或 Cloud KMS 密钥。
      • 如果您选择的是 Cloud KMS 密钥：
        • 在密钥管理类型列表中，选择适当的类型。
        • 在 Cloud KMS 密钥列表中，选择相应密钥。
      如需了解详情，请参客户管理的加密密钥。

9. 点击继续。

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

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

创建数据存储区后，创建应用，将其连接到 Zendesk 数据存储区，并在执行任何查询之前授权 Gemini Enterprise 访问 Zendesk。

如需了解执行搜索所需的权限，请参阅所需权限。

数据处理和查询执行

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

查询执行

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

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

数据处理

使用第三方联合搜索时，遵循以下数据处理规则：

• 您的查询字符串会发送到第三方搜索后端 (Zendesk API)。
• 这些第三方可能会将查询与您的身份关联。
• 如果启用了多个联合搜索数据源，查询可能会发送到所有这些数据源。
• 数据到达第三方系统后，将受该系统的服务条款和隐私权政策的约束。

注意：为了提高准确性，LLM 可能会在将查询发送给 Zendesk 之前重写查询。重写的查询可能会包含您会话的查询记录中的信息。因此，查询历史记录的部分内容可能也会包含在发送到 Zendesk API 的查询中。

后续步骤

• 如需提供用于查询数据的界面，请创建应用，然后将其关联到 Zendesk 数据存储区。
• 如需在设置应用后预览搜索结果以了解其显示方式，请参阅获取搜索结果。
• 如需为数据存储区启用提醒，请参阅为第三方数据存储区配置提醒。