Salesforce 集成

将 LangSmith Fleet 连接到 Salesforce，使你的 agent 能够查询记录、浏览模式并读取自定义字段。

Salesforce 集成让你的 agent 以只读方式访问 Salesforce 组织中的数据。连接后，agent 可以：

• 跨标准对象和自定义对象查询记录。
• 浏览 Salesforce 数据模式，包括关系和自定义字段。
• 将 Salesforce 中的实时上下文拉取到任何线程或计划运行中。

NOTE

连接 Salesforce 是每个 Salesforce 组织的一次性设置。Salesforce 系统管理员（或拥有 Approve Uninstalled Connected Apps 权限的用户）必须先安装连接器，其他用户才能进行身份验证。

前置条件

• 一个有权访问 Fleet 的 LangSmith 工作区。
• 一个 Salesforce 组织和用户账户。
• 一位 Salesforce 系统管理员来完成安装（或你自己的用户拥有 Approve Uninstalled Connected Apps 权限）。

注册连接器

首次连接尝试会在你的 Salesforce 组织中注册 LangChain Fleet Connector，以便管理员安装它。预计此次初始尝试会因身份验证错误而失败。

Open the Integrations page

在 LangSmith UI 中，导航到 Fleet > Integrations 选项卡。

Start the Salesforce connection

找到 Salesforce 工具并点击 Connect。

Sign in to Salesforce

使用你的 Salesforce 凭据登录。如果你的组织需要自定义域或 SSO，请点击 Use Custom Domain 并在登录前输入组织的 My Domain。然后点击 Allow 授权连接。

INFO

首次尝试按设计会失败。失败的请求会在你的 Salesforce 组织中注册 LangChain Fleet Connector，以便管理员在下一步中安装它。

TIP

如果你不是 Salesforce 管理员，请在此停止，并将此页面链接发送给你的管理员。他们需要按照下面的 Install the connector 和 Grant user access 步骤操作，你才能完成连接。

安装连接器

NOTE

此步骤必须由 Salesforce 系统管理员完成。

Open Salesforce Setup

在 Salesforce 中，点击

•

齿轮图标并选择 Setup。

Open Connected Apps OAuth Usage

在 Quick Find 框中，输入 Connected Apps OAuth Usage 并打开该页面。

Install the connector

1. 在列表中找到 LangChain Fleet Connector。
2. 点击 Install。
3. 在下一页确认安装。

授予用户访问权限

通过权限集授予访问权限是控制哪些用户可以使用 Fleet 进行身份验证的推荐方式。

NOTE

此步骤必须由 Salesforce 系统管理员完成。

Open the app policies

在 Connected Apps OAuth Usage 中，点击 LangChain Fleet Connector 旁的 Manage App Policies。

Pre-authorize admin-approved users

在 OAuth Policies > Permitted Users 下，选择 Admin approved users are pre-authorized，然后点击 Save。

Assign a permission set

使用 Manage Permission Sets 向需要在 Fleet 中连接 Salesforce 工具的用户授予访问权限。

从 Fleet 连接

管理员安装连接器并授予访问权限后，返回 Fleet 完成连接。

1. 在 LangSmith UI 中，导航到 Fleet > Integrations 选项卡。
2. 找到 Salesforce 工具并点击 Connect。
3. 使用你的 Salesforce 凭据登录并点击 Allow。

现在连接成功，Salesforce 工具可供工作区中的 agent 使用。

在 agent 中使用 Salesforce

连接后，将 Salesforce 工具添加到特定 agent：

1. 在 Fleet 中打开你的 agent。
2. 在侧边栏中，展开 Connections 抽屉并点击 Add connection。
3. 搜索 Salesforce Query 并将其添加到 agent。

故障排查

连接因身份验证错误而失败

首次连接尝试预计会失败。它会在你的 Salesforce 组织中注册 LangChain Fleet Connector，以便管理员安装。如果安装连接器后连接仍然失败，请确认：

• 管理员已完成 Install the connector 和 Grant user access 两项操作。
• 你的 Salesforce 用户已分配到授予连接器访问权限的权限集。
• 你通过 Use Custom Domain 并使用正确的 Salesforce 域登录。

Agent 无法看到对象或字段

Salesforce 工具以连接用户的权限运行。如果 agent 无法读取某个对象或自定义字段，请验证该用户的 Salesforce 配置文件和权限集是否授予对该对象的读取访问权限。

后续步骤

•Add more tools

将更多服务连接到你的 agent

•Agent identity

选择 agent 使用共享凭据还是每用户凭据

✓Human-in-the-loop

在 agent 执行敏感操作前要求批准

---