UiPath Documentation
integration-service
latest
false
Integration Service 用户指南
重要 :
请注意,此内容已使用机器翻译进行了本地化。 Integration Service 中提供的连接器包采用的是机器翻译的译文。 新发布内容的本地化可能需要 1-2 周的时间才能完成。

Agentforce 和流程连接器的 Salesforce 设置

配置 Salesforce,以在 Integration Service 中启用 Agentforce 和 Flows 连接器,包括所需的配置文件、版本和 API 权限。

本指南概述了使用 Integration Service Salesforce 代理和流程连接器所需的基本 Salesforce 设置。

先决条件​

开始之前,请确保满足以下条件:

  • 您拥有已启用 API 的系统管理员配置文件访问权限。

  • 您的 Salesforce 版本为 Enterprise Edition、Unlimited Edition 或 Developer Edition。

您可以使用当前的 Salesforce 组织,也可以按照Salesforce Agentforce 开发者工具页面上的安装说明设置新的 Agentforce Developer Edition。

安装和配置 Salesforce 流程代理托管包​

备注:

与 Salesforce 流程集成需要执行此步骤。要与 Salesforce Agentforce 集成,请完全跳过此步骤,直接进入在 Salesforce 中配置已连接的应用程序。

访问并安装 AppExchange 列表​

请按照以下步骤安装 UiPath Maestro Connector for Salesforce 流程托管包:

  1. 在网页浏览器中,访问以下网页: Salesforce AppExchange 。
  2. 在搜索栏中,键入: UiPath Maestro Connector for Salesforce Flow(UiPath Maestro 连接器适用于 Salesforce 流程) 。
  3. 选择该应用程序列表,然后选择“立即获取” 。
  4. 使用您的 Salesforce 凭据登录以继续安装。
  5. 选择安装环境:
    1. 生产:适用于实时 Salesforce 环境。
    2. 沙盒:用于生产使用前的测试。注意:当 UiPath 连接器处于预览阶段时,无法选择环境。
  6. 选择“仅为管理员安装” 。此选择仅向系统管理员授予包访问权限。或者,您可以选择将托管包提供给具有适当权限的特定用户。
  7. 选中确认安装非 Salesforce 应用程序的框。
  8. 选择“安装” 。
  9. 成功安装后,选择“完成” 。
  10. 通过检查“UiPath Maestro Connector for Salesforce 流程连接器”的已安装包列表来验证安装。

分配权限集​

要向有权访问受托管包的用户授予必要的权限,请执行以下操作:

  1. 导航至“设置” > “用户” > “权限集” 。
  2. 找到Agentforce 默认管理员(默认管理员) 。
  3. 选择“管理分配” 。
  4. 选择“添加分配” 。
  5. 选择所需用户。
  6. 选择“下一步” ,然后选择“分配” 。

在 Salesforce 中配置已连接的应用程序​

创建已连接的应用程序​

  1. 打开“应用程序管理器” ,选择窗口右上角的齿轮图标,然后选择“设置” 。

  2. 在左侧边栏的“快速查找”框中,键入,然后选择“应用程序管理器” 。系统将显示 Salesforce 组织中已提供的应用程序列表。

  3. 选择窗口右上角的“新建已连接的应用程序”按钮。

    图 2. 创建新的已连接的应用程序

  4. 选择“创建连接的应用程序” ,然后选择 “继续” 。

    图 3.创建已连接的应用程序窗口

  5. 填写新连接的应用程序的“基本信息”部分:

    1. 提供名称。例如,UiPath Salesforce Agentforce 流程连接器。
    2. API 名称:此字段会根据提供的应用名称自动填充。
    3. 提供联系人电子邮件地址: 输入您用于支持通信的电子邮件地址。
  6. 要为新应用程序启用 OAuth 设置,请滚动到“API”(启用 OAuth 设置)部分。

    1. 选择“启用 OAuth 设置”复选框。
    2. 通过提供连接器回调 URL 来指定回调 URL : https://{baseURL}/provisioning_/callback (例如,对于 Automation Cloud,为https://cloud.uipath.com/provisioning_/callback )。
    3. 添加所需的OAuth 作用域:
      • 对于 Salesforce 流程:
        • 完全访问权限 ( full )
        • 随时执行请求( refresh_token 、 offline_access )
      • 对于 Salesforce Agentforce:
        • 访问 Chatbot 服务 ( chatbot_api )
        • 访问 Salesforce API 平台 ( sfap_api )
        • 完全访问权限 ( full )
        • 通过 API 管理用户数据 ( api )
        • 随时执行请求( refresh_token 、 offline_access )
  7. 管理已连接应用程序的安全设置:

    1. 启用以下复选框:
      1. 客户端凭据流程:启用后,在以下弹出窗口中选择“确定” ,以确认拥有使用者密钥和使用者密码的任何人都可以代表所选用户访问您的组织。
      2. 为已命名用户发布基于 JSON 网页令牌 (JWT) 的访问令牌– 如果您打算使用 OAuth 2.0 授权代码通过 Integration Service 连接器进行身份验证,请不要启用此复选框。
    2. 禁用以下复选框:
      1. 需要验证密钥进行代码交换 (PKCE) 扩展以实现受支持的授权流程

      2. Web 服务器流需要密码

      3. 刷新令牌流程需要密码

        图 4. 已连接的应用程序 API 设置

  8. 选择“保存”以保存应用程序。系统将显示以下消息:“更改最多可能需要 10 分钟才能生效。删除父组织也会删除所有已启用 OAuth 设置的已连接应用程序。

检索客户端 ID 和客户端密码​

  1. 返回到“应用程序管理器” 。

  2. 找到您的应用程序 (UiPath Salesforce Agentforce Flows Connector),选择右侧的下拉箭头,然后选择“查看” 。

    图 5. 查看应用程序详细信息

  3. 选择“管理使用者详细信息” 。

  4. 如果出现提示,请完成安全验证步骤。Salesforce 可能会要求您将验证码发送到您注册的电子邮件地址。出现提示时输入代码以继续。

  5. 系统将显示以下凭据:

    • 使用者密钥– 表示客户端 ID。
    • 使用者密码– 表示客户端密码。重要提示:复制并安全地存储这两个值。需要使用这些凭据才能配置 Integration Service 连接器。

为 JWT 和客户端凭据流程配置连接的应用程序​

  1. 转到“设置” > “管理已连接的 Apps” 。
  2. 找到并选择已连接的应用程序 (UiPath Salesforce Agentforce 流程连接器)。
  3. 选择“编辑策略” :
    1. 在“客户端凭据流程”下,配置“以用户身份运行” 字段。连接器会模拟该用户,以调用流程和智能体的 API。注意:这是连接器的服务帐户。确保选择具有所需权限(“仅 API 访问”或“已启用 API”)的用户。
    2. 在基于JWT 的访问令牌针对已命名用户的设置下:
      • 选中“颁发基于 JSON Web 令牌 (JWT) 的访问令牌”复选框。

      • 将“令牌超时”值设置为 30 分钟。

        图 6.已命名用户的基于 JWT 的访问令牌设置

  4. 选择“保存”。

启用 UiPath 连接器访问自定义 Agentforce 代理​

备注:

Agentforce(默认)智能体不需要此步骤。

对于每个自定义代理,请执行以下步骤:

  1. 转到“设置”并搜索“智能体”。

  2. 选择“Agentforce 智能体” 。

  3. 在“为用户授予 Agentforce(默认)智能体的访问权限”部分中,选择自定义智能体的名称(例如 “My Agentforce 服务智能体”)。

    图 7. 向用户授予 Agentforce 智能体的访问权限

  4. 选择连接选项卡,然后选择添加。

    图 8. 为自定义 Agentforce 智能体配置连接

  5. 在“添加连接”窗口中:

    1. 将连接字段设置为API 。

    2. 提供集成名称,例如“UiPath 连接器”。

    3. 在“已连接的应用程序”下,选择您之前创建的已连接应用程序(UiPath Salesforce Agentforce & Flows Connector)。

      图 9. UiPath Salesforce Agentforce Flows 连接器

    4. 保存连接。

配置远程站点设置​

  1. 从“应用程序管理器”中,选择窗口右上角的齿轮图标,然后选择“设置” 。
  2. 在左侧边栏的“快速查找”框中,输入“远程站点设置” 。
  3. 在“安全”下,选择“远程站点设置” 。
  4. 选择“新建远程站点”以创建新站点。
  5. 通过提供以下信息来配置新站点:
    • “远程站点名称” : 输入不带空格的字母数字字符串,例如UiPathRemoteSite 。
    • 远程站点 URL :输入基本 URL,例如: https://cloud.uipath.com 。
    • 说明:输入说明,例如:“流程调用的 UiPath 集成基本 URL”。此字段是可选的。
    • 活动: 确保选中复选框。
  6. 选择“保存”以确认并激活这些设置。

您的 UiPath 连接器现在可以访问自定义 Salesforce 代理。确保要调用的代理已激活。

接下来,配置 Salesforce Agentforce Integration Service 中的流连接器。转到Salesforce Agentforce & Flows authentication以创建连接。

常见问题和故障排除​

以下部分列出了在配置 Salesforce Flow Agents 托管的包或已连接的应用程序时可能遇到的常见问题,以及解决这些问题的方法。

问题:由于缺少依赖项,受管理包安装失败​

  1. 确保启用了所有必需的 Salesforce 功能(如 API 访问和 AI)。
  2. 检查安装日志中的包依赖项。

问题:用户无法访问某些功能​

  • 验证是否已为代理的服务帐户用户和最终用户分配了正确的配置文件和权限集。
  • 确保您已激活代理。

问题: 外部系统无法连接到 Salesforce​

  • 检查 API 设置,并确保为连接的应用程序配置了 OAuth 身份验证。

监控和验证通过 UiPath 连接器触发的自动启动流程的执行状态​

请按照以下步骤访问 Salesforce 中的自定义流程执行日志对象:

  1. 导航至应用启动器(左上角的网格图标)。

  2. 在搜索栏中搜索流程执行。

  3. 选择“流程执行”选项卡或搜索结果中显示的对象名称。此操作将打开流程执行记录的列表视图。系统将为通过 UiPath 连接器触发的每个流程创建一个新记录。

    图 10.流程执行记录

  4. 选择特定的流程执行名称,以查看该执行的详细信息。

    图 11.流程执行详情

此页面有帮助吗?

连接

需要帮助? 支持(opens in new window)

想要了解详细内容? UiPath Academy(opens in new window)

有问题? UiPath 论坛(opens in new window)

保持更新