Agentforce 和流程连接器的 Salesforce 设置

本指南概述了使用 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-SF-Flow-Agents-Integration 托管的包：

1. 在网页浏览器中，访问以下网页： Salesforce AppExchange 。
   重要提示：对于 Salesforce Agentforce 和流程连接器的当前预览版，请使用以下 URL 访问包： https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0=04tPa000000bkIPIAY ，并将<yourSalesforceDomain>替换为您的组织域。
2. 在搜索栏中，键入： UiPath-SF-Flow-Agents-Integration 。
3. 选择该应用程序列表，然后选择“立即获取” 。
4. 使用您的 Salesforce 凭据登录以继续安装。
5. 选择安装环境:
   1. 生产：适用于实时 Salesforce 环境。
   2. 沙盒：用于生产使用前的测试。

      注意：当 UiPath 连接器处于预览阶段时，无法选择环境。

6. 选择“仅为管理员安装” 。

   此选择仅向系统管理员授予包的访问权限。或者，您可以选择将托管包提供给具有适当权限的特定用户。

7. 选中确认安装非 Salesforce 应用程序的框。
8. 选择“安装” 。
9. 成功安装后，选择“完成” 。
10. 通过检查 "UiPath-SF-flow-gents-integration" 的已安装包列表来验证安装。
    图 1.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://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 Web 令牌 (JWT) 的访问令牌- 如果您打算使用 OAuth 2.0 授权代码通过 Integration Service 连接器进行身份验证，请不要启用此复选框。
   2. 禁用以下复选框：
      1. 需要验证密钥进行代码交换 (PKCE) 扩展以实现受支持的授权流程
      2. Web 服务器流需要密码
      3. 刷新令牌流程需要密码
         图 4.已连接的应用程序 API 设置
         

         

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

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

1. 返回到“应用程序管理器” 。
2. 找到您的应用程序（UiPath Salesforce Agentforce 流程连接器），选择右侧的下拉箭头，然后选择“查看” 。
   图 5.查看应用程序详细信息
   

   

   
   
3. 选择“管理使用者详细信息” 。
4. 如果出现提示，请完成安全验证步骤。Salesforce 可能会要求您将验证码发送到您注册的电子邮件地址。出现提示时输入代码以继续。
5. 系统将显示以下凭据：
   • 使用者密钥– 表示客户端 ID。
   • 使用者密码– 表示客户端密码。
   重要提示：复制并安全存储这两个值。这些凭据是配置 Integration Service 连接器的必要项。

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

1. 转到“设置” > “管理已连接的 Apps” 。
2. 找到并选择已连接的应用程序 (UiPath Salesforce Agentforce 流程连接器)。
3. 选择“编辑策略” ：
   1. 在“客户端凭据流程”下，配置“以用户身份运行”字段。连接器模拟此用户，以调用流程和代理的 API。
      注意：这是连接器的服务帐户。确保选择具有所需权限（“仅 API 访问”或“启用 API”）的用户。
   2. 在“命名用户的基于 JWT 的访问令牌设置”下：
      • 启用“发布基于 JSON 网页令牌 (JWT) 的访问令牌”复选框。
      • 将“令牌超时”值设置为 30 分钟。
        图 6.已命名用户的基于 JWT 的访问令牌设置
        

        

        
        
4. 选择“保存”。

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

注意： “代理强制（默认）”代理不需要此步骤。

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

1. 转到“设置” ，然后搜索“代理”。
2. 选择“Agentforce 代理” 。
3. 在“向用户授予 Agentforce（默认）代理的访问权限”部分中，选择自定义代理的名称（例如，My Agentforce 服务代理）。
   图 7.向用户授予 Agentforce 代理的访问权限
   

   

   
   
4. 选择“连接”选项卡，然后选择“添加” 。
   图 8.为自定义 Agentforce 代理配置连接
   

   

   
   
5. 在“添加连接”窗口中：
   1. 将连接字段设置为API 。
   2. 提供集成名称，例如“UiPath 连接器”。
   3. 在“已连接的应用程序”下，选择您先前创建的已连接的应用程序（UiPath Salesforce AgentForce 流程连接器）。
      图 9. UiPath Salesforce AgentForce 流程连接器
      

      

      
      
   4. 保存连接。

配置远程站点设置

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

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

接下来，在 Integration Service 中配置 Salesforce AgentForce 和流连接器。转到Salesforce Agentforce 和流程身份验证以创建连接。

常见问题和故障排除

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

问题：由于缺少依赖项，受管理包安装失败

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

问题：用户无法访问某些功能

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

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

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

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

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

1. 导航至“应用程序启动器” （左上角的网格图标）。
2. 在搜索栏中搜索流程执行。
3. 选择搜索结果中显示的“流程执行”选项卡或对象名称。此操作将打开流程执行记录的列表视图。系统会为通过 UiPath 连接器触发的每个流程创建一个新记录。
   图 10.流程执行记录
   

   

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