设置 Salesforce 数据存储区

本页面介绍了如何创建数据存储区并将 Salesforce 关联到 Gemini Enterprise。数据存储区会实时搜索您的 Salesforce 记录，并允许最终用户使用自然语言对这些记录执行操作。

准备工作

在设置 Salesforce 连接之前，请先执行以下操作：

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

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

      进入 IAM

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

  2. 让 Salesforce 管理员在您要连接的 Salesforce 组织中启用 SObject All MCP 服务器，并配置您选择的身份验证方法：

    • OAuth 2.0（Google 管理）（默认）：从 Salesforce AppExchange 将 Gemini Enterprise - Salesforce Connector 受管软件包安装到该组织中。您不需要客户端 ID 或客户端密钥。
    • OAuth 2.0（自带应用）：在该组织中创建外部客户端应用，并获取其使用方密钥（客户端 ID）和使用方密钥（客户端密钥）。

    在配置 OAuth 应用之前，用户无法授权连接器；在 SObject All MCP 服务器处于活跃状态之前，无法执行任何操作。请参阅 Salesforce 配置。

  3. 记下贵组织的“我的网域”网址，例如 https://example.my.salesforce.com。您需要将其输入为实例 URI。 对于沙盒组织，请使用沙盒“我的网域”，例如 https://example--sandbox.sandbox.my.salesforce.com。

查找您的“我的网域”网址

如需查找要作为实例 URI 输入的“我的网域”网址，请执行以下操作：

  1. 在 Salesforce 中，前往设置。
  2. 在快速查找框中，搜索并选择我的网域。
  3. 在 Current My Domain URL（当前我的网域网址）下，复制网址，例如 https://example.my.salesforce.com。

对于沙盒组织，请在沙盒中执行此操作。其“我的网域”网址类似于 https://example--sandbox.sandbox.my.salesforce.com。

创建 Salesforce 数据存储区

如需创建 Salesforce 数据存储区，请按以下步骤操作：

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

    Gemini Enterprise

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

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

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

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

  6. 在数据部分中：

    1. 在身份验证设置下，对于选择身份验证方法，选择以下选项之一：

      • OAuth 2.0（Google 管理）（默认）：
        1. 在实例 URI 部分，输入 Salesforce 网站的“我的网域”网址，例如 https://example.my.salesforce.com。对于沙盒组织，请输入沙盒的“我的网域”，例如 https://example--sandbox.sandbox.my.salesforce.com。
      • OAuth 2.0（自带应用）：
        1. 在实例 URI 部分，输入 Salesforce 网站的“我的网域”网址，例如 https://example.my.salesforce.com。对于沙盒组织，请输入沙盒的“我的网域”，例如 https://example--sandbox.sandbox.my.salesforce.com。
        2. 在客户端 ID 部分，输入 Salesforce 外部客户端应用的使用方密钥。
        3. 在客户端密钥部分，输入 Salesforce 外部客户端应用的使用方密钥。
        4. 点击验证身份验证，然后完成 Salesforce 登录以验证您的 OAuth 凭据。

    2. 在高级选项下，如果您要连接沙盒组织，请选择使用沙盒。然后，Salesforce 会从您的沙盒组织提供操作。

    3. 点击继续。

    4. 在要搜索的实体部分，选择您希望 Gemini Enterprise 搜索的实体。对于 Salesforce，请选择 Salesforce MCP。

  7. 点击继续。

  8. 可选：在操作部分，选择您要为用户启用的创建、更新和删除操作，或不选择这些操作，以使连接器保持只读状态（默认情况下，只读操作处于启用状态）。您还可以在创建数据存储区后启用或停用这些操作；请参阅启用操作。

  9. 点击继续。

  10. 在配置部分中：

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

  11. 点击继续。

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

  13. 点击创建。Gemini Enterprise 会创建数据存储区，并在数据存储区页面上显示这些数据存储区。

在数据存储区页面上，点击数据存储区名称以查看状态。当数据存储区状态从正在创建变为活跃后，Salesforce 数据存储区即可供使用。

创建数据存储区后，将您刚刚创建的数据存储区连接到现有应用，或创建新应用并将其连接到新应用，然后在执行任何查询之前授权 Gemini Enterprise 访问 Salesforce。

启用操作

创建 Salesforce 数据存储区时，其操作会预先填充到数据存储区中。只读操作（Soql 查询、查找、获取对象架构、获取相关记录、列出最近的 Sobject 记录和获取用户信息）默认处于启用状态，并且始终可用。创建、更新或删除记录的操作（创建 Sobject 记录、更新 Sobject 记录、更新相关记录、删除 Sobject 记录和删除相关记录）默认处于关闭状态。

如果您在创建数据存储区期间未启用创建、更新或删除操作，则可以随时按照以下步骤启用这些操作：

  1. 在 Google Cloud 控制台中，前往您的 Salesforce 数据存储区。

  2. 选择操作标签页。

  3. 选择要启用的操作（创建 Sobject 记录、更新 Sobject 记录、更新相关记录、删除 Sobject 记录或删除相关记录）。如需让连接器保持只读状态，请勿选择这些操作。

  4. 点击启用操作。

如需查看操作列表，请参阅支持的操作。

数据处理和查询执行

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

查询执行

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

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

数据处理

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

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

后续步骤