设置 Zendesk 数据存储区

本页面介绍了如何创建数据存储区并将 Zendesk 关联到 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 地址列入许可清单之前,同步运行将失败。如需了解详情,请参阅配置静态 IP 出站流量。
      2. 每分钟的 API 请求数上限:每次运行连接器时,每分钟可向 Zendesk 实例发送的 API 请求数上限。
      3. 点击继续。
    6. 在要搜索的实体部分,从列表中选择要搜索的所有实体。您必须至少选择一个实体。

  7. 点击继续。

  8. 在操作部分中,对于选择要启用的 Zendesk 操作,请从类别中选择操作以针对数据存储区启用这些操作。

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

  9. 点击继续。

  10. 在配置部分中:

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

  11. 点击继续。

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

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

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

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

数据处理和查询执行

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

查询执行

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

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

数据处理

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

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

后续步骤