Salesforce 集成为您的代理提供对 Salesforce 组织中数据的只读访问权限。连接后，代理可以：
- - 跨标准和自定义对象查询记录。
- - 浏览您的 Salesforce 数据架构，包括关系和自定义字段。
- - 将 Salesforce 中的实时上下文拉取到任何对话或计划运行中。
前提条件
- - 一个可访问 LangSmith 的工作区 车队.
- - 一个 Salesforce 组织及用户账户。
- - 需要 Salesforce 系统管理员来完成安装（或 **批准已卸载的已连接应用** 在您自己的用户身上的权限）。
注册连接器
首次连接尝试会在 **LangChain Fleet 连接器** 中注册，以便管理员可以安装它。此初始尝试预计会因身份验证错误而失败。
Open the Integrations page
在 LangSmith UI中，导航到 **车队** > **集成** tab.
Start the Salesforce connection
找到 **Salesforce** 工具并点击 **连接**.
Sign in to Salesforce
使用您的 Salesforce 凭据登录。如果您的组织需要自定义域或 SSO，请点击 **使用自定义域** 并在登录前输入您组织的“我的域名”。然后点击 **允许** 授权连接。
安装连接器
Open Salesforce Setup
在 Salesforce 中，点击 齿轮图标并选择 **设置**.
Open Connected Apps OAuth Usage
在 **快速查找** 框，类型 Connected Apps OAuth Usage 并打开页面。
Install the connector
1. 找到 **LangChain Fleet Connector** 在列表中。 1. 点击 **安装**. 1. 在下一页确认安装。
授予用户访问权限
通过权限集授予访问权限是控制哪些用户可以向 Fleet 进行身份验证的推荐方式。
Open the app policies
从 **Connected Apps OAuth Usage**，点击 **Manage App Policies** 旁边的 **LangChain Fleet Connector**.
Pre-authorize admin-approved users
在 **OAuth Policies** > **允许的用户**下，选择 **管理员批准的用户已获预授权**，然后点击 **保存**.
Assign a permission set
使用 **Manage Permission Sets** 向需要连接 Fleet 中 Salesforce 工具的用户授予访问权限。
从 Fleet 连接
管理员安装连接器并授予访问权限后，返回 Fleet 完成连接。
- 在 LangSmith UI中，导航到 **Fleet** > **集成** tab.
- 找到 **Salesforce** 工具并点击 **连接**.
- 使用您的 Salesforce 凭据登录，然后点击 **允许**.
连接现在成功，您的工作区中的代理可以使用 Salesforce 工具。
将 Salesforce 与代理配合使用
连接后，将 Salesforce 工具添加到特定代理：
- 在 Fleet 中打开您的代理并点击 **编辑代理** icon.
- 在 **工具箱** 部分，点击 **+ 添加**.
- 搜索 **Salesforce Query** 并将其添加到代理。
- 点击 **保存更改**.
故障排除
连接失败并出现身份验证错误
首次连接尝试预计会失败。它会在您的 **LangChain Fleet Connector** 中注册到您的 Salesforce 组织，以便管理员可以安装它。如果连接器安装后连接仍然失败，请确认：
- - 管理员已完成 **安装连接器** 和 **授予用户访问权限**.
- - 您的 Salesforce 用户被分配了授予连接器访问权限的权限集。
- - 您已通过 **使用自定义域** 和正确的 Salesforce 域登录。
代理无法查看对象或字段
Salesforce 工具使用已连接用户的权限运行。如果代理无法读取对象或自定义字段，请验证用户的 Salesforce 配置文件和权限集是否授予了对该对象的读取访问权限。
后续步骤
Add more tools
将其他服务连接到您的代理
Agent identity
选择代理是使用共享还是每用户凭据
Human-in-the-loop
在代理执行敏感操作前需要批准