> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce 集成

> 将 LangSmith Fleet 连接到 Salesforce，以便您的代理可以查询记录、导航模式并读取自定义字段。

Salesforce 集成赋予您的代理对 Salesforce 组织中数据的只读访问权限。连接后，代理可以：

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

<Note>
  连接 Salesforce 是每个 Salesforce 组织的一次性设置。必须由 Salesforce
  系统管理员（或拥有 **批准未安装的已连接应用**
  权限的用户）安装连接器，然后其他用户才能进行身份验证。
</Note>

## 先决条件

* 一个有权访问 [Fleet](https://smith.langchain.com/agents) 的 LangSmith 工作区。
* 一个 Salesforce 组织和用户账户。
* 一个 Salesforce 系统管理员来完成安装（或者您自己的用户拥有 **批准未安装的已连接应用** 权限）。

## 注册连接器

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

<Steps>
  <Step title="打开集成页面">
    在 [LangSmith UI](https://smith.langchain.com) 中，导航到 [**Fleet** > **集成**](https://smith.langchain.com/agents/tools) 标签页。
  </Step>

  <Step title="启动 Salesforce 连接">
    找到 **Salesforce** 工具并点击 **连接**。
  </Step>

  <Step title="登录 Salesforce">
    使用您的 Salesforce 凭据登录。如果您的组织需要自定义域或 SSO，请点击 **使用自定义域** 并在登录前输入您组织的 My Domain。然后点击 **允许** 以授权连接。
  </Step>
</Steps>

<Info>
  首次尝试按设计失败。失败的请求会在您的 Salesforce 组织中注册 **LangChain Fleet
  连接器**，以便管理员可以在下一步中安装它。
</Info>

<Tip>
  如果您不是 Salesforce
  管理员，请在此处停止并将此页面的链接发送给您的管理员。他们需要按照下面的
  **安装连接器** 和 **授予用户访问权限** 步骤操作，然后您才能完成连接。
</Tip>

## 安装连接器

<Note>此步骤必须由 Salesforce 系统管理员完成。</Note>

<Steps>
  <Step title="打开 Salesforce 设置">
    在 Salesforce 中，点击 <Icon icon="settings" /> 齿轮图标并选择 **设置**。
  </Step>

  <Step title="打开已连接应用 OAuth 使用情况">
    在 **快速查找** 框中，输入 `Connected Apps OAuth Usage` 并打开该页面。
  </Step>

  <Step title="安装连接器">
    1. 在列表中找到 **LangChain Fleet 连接器**。 1. 点击 **安装**。 1.
       在下一页确认安装。
  </Step>
</Steps>

## 授予用户访问权限

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

<Note>此步骤必须由 Salesforce 系统管理员完成。</Note>

<Steps>
  <Step title="打开应用策略">
    从 **已连接应用 OAuth 使用情况** 中，点击 **LangChain Fleet 连接器** 旁边的 **管理应用策略**。
  </Step>

  <Step title="预授权管理员批准的用户">
    在 **OAuth 策略** > **允许的用户** 下，选择 **管理员批准的用户已预授权**，然后点击 **保存**。
  </Step>

  <Step title="分配权限集">
    使用 **管理权限集** 向需要在 Fleet 中连接 Salesforce 工具的用户授予访问权限。
  </Step>
</Steps>

## 从 Fleet 连接

一旦您的管理员安装了连接器并授予了访问权限，请返回 Fleet 完成连接。

1. 在 [LangSmith UI](https://smith.langchain.com) 中，导航到 [**Fleet** > **集成**](https://smith.langchain.com/agents/tools) 标签页。
2. 找到 **Salesforce** 工具并点击 **连接**。
3. 使用您的 Salesforce 凭据登录并点击 **允许**。

现在连接成功，Salesforce 工具在您的工作区中对代理可用。

## 将 Salesforce 与代理一起使用

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

1. 在 [Fleet](https://smith.langchain.com/agents) 中打开您的代理并点击 <Icon icon="pencil" /> **编辑代理** 图标。
2. 在 **工具箱** 部分，点击 **+ 添加**。
3. 搜索 **Salesforce Query** 并将其添加到代理。
4. 点击 **保存更改**。

## 故障排除

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

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

* 管理员已完成 **安装连接器** 和 **授予用户访问权限** 两个步骤。
* 您的 Salesforce 用户被分配到一个授予连接器访问权限的权限集。
* 您通过 **使用自定义域** 使用正确的 Salesforce 域登录。

### 代理看不到某个对象或字段

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

## 后续步骤

<CardGroup cols={3}>
  <Card title="添加更多工具" icon="puzzle" href="/langsmith/fleet/tools">
    将其他服务连接到您的代理
  </Card>

  <Card title="代理身份" icon="user" href="/langsmith/fleet/agent-identity">
    选择代理是使用共享凭据还是每用户凭据
  </Card>

  <Card title="Human in the Loop" icon="check" href="/langsmith/fleet/essentials#human-in-the-loop">
    要求在代理执行敏感操作前获得批准
  </Card>
</CardGroup>

***

<div className="source-links">
  <Callout icon="terminal-2">
    [通过 MCP 将这些文档](/use-these-docs) 连接到 Claude、VSCode
    等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub
    上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/fleet/salesforce.mdx)
    或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>