以编程方式使用文档

LangSmith Fleet 基础知识是构成您的代理基础的核心功能。包括工具、渠道、记忆、子代理和审批。

代理身份

代理身份控制 凭据 代理在与应用和服务交互时使用。

查看 代理身份 了解更多信息。

渠道

渠道定义您的代理何时开始运行。您可以将代理连接到外部工具或基于时间的计划，让它自动响应消息、电子邮件或周期性事件。

查看 渠道 了解设置说明和支持的渠道类型。

自定义模型

Fleet 支持自定义模型。您可以连接任何支持 **OpenAI 聊天补全规范** or **Anthropic 聊天规范**.

常见用例包括：

  • LLM 代理：通过 LiteLLM、Portkey 或您自己的代理等服务路由请求。
  • 自托管模型：连接到在您自己的基础设施上运行的模型。
  • 替代提供商：使用任何具有兼容 API 的提供商。

添加自定义模型：

  1. 在 LangSmith UI中，导航到要编辑的代理。
  2. 点击右上角的 设置图标。
  3. 在 **模型** 部分，选择 **+ 添加自定义模型**.
  4. 输入模型 ID、显示名称、基础 URL 以及 API 密钥名称和值。
  5. 点击 **保存**.

Human-in-the-loop

保持对重要决策的控制。您可以设置代理在执行某些操作之前暂停并请求您的批准。这确保您的代理自动处理大多数任务，同时您保留监督权。

设置审批步骤

Select a tool

设置代理时，选择要在运行前审查的工具或操作。

Turn on approval

找到该工具的审批选项并打开它。

Agent waits for you

当您的代理到达该步骤时，它将暂停并等待您的批准后再继续。

代理暂停时您可以做什么

当您的代理停止请求批准时，您有三个选项：

Accept

批准并让您的代理继续执行其计划。

Edit

在允许代理继续之前，修改其消息或参数。

Send feedback

分享反馈以帮助您的代理学习和改进。

说明

说明是定义代理行为、个性和能力的系统提示。它们指导代理如何解释请求、使用工具和响应用户。

编辑说明：

  1. 在 LangSmith UI中，导航到您要编辑的代理。
  2. 点击 **编辑** 右上角。
  3. 在 **说明** 面板中，点击 **编辑**.
  4. 编辑说明。
  5. 点击 **完成** 然后 **保存更改**.

记忆

代理会记住之前对话中的重要信息，并能自我更新以更好地工作。Fleet 代理使用两种记忆来源：

  • 线程范围记忆：当前对话线程的上下文，包括该线程中的消息和操作。
  • 长期记忆：代理工作区中的持久文件，例如 AGENTS.md, tools.json （工具配置）， subagents/*和 skills/*。这些在运行时加载，并在每次运行开始时可用。 AGENTS.md 会自动插入系统提示中。其他长期文件不会自动添加到提示中；代理必须按需读取它们（例如，使用 read_file 工具）。

代理通过将文件写入 **记忆文件夹** （使用 write_file 和 edit_file 工具调用）来持久化过去交互的相关详细信息。这有助于他们在未来的对话中做出更好的决策。

更多信息，请参阅 我们如何为 Fleet 构建记忆系统（以前称为 Agent Builder）.

Self-updates

代理可以自我更新：它们可以添加工具、删除不需要的工具或调整说明。但是，代理无法更改其名称、描述或启动它们的渠道。

技能

技能是一种打包能力的方式，在上下文并非普遍适用的场景中提供更具体的信息。

使用技能可以帮助：

  • - 仅提供与当前任务相关的上下文来节省 token 用量。
  • - 防止智能体在系统提示词中包含过多上下文，这可能导致幻觉和错误响应。

更多信息，请参阅 技能.

Sub-agents

通过将大型任务拆分为更小的专业助手来构建复杂的智能体。可以将子智能体想象成一个专家团队——每个专家负责处理工作的特定部分，同时与主智能体协同工作。

这种方法使构建复杂系统变得更加容易。与其让一个智能体尝试完成所有工作，不如让专业助手各自擅长其任务的一部分。

以下是一些使用子智能体的方式：

  • - 拆分为子任务：让一个智能体获取数据，另一个总结数据，第三个格式化结果。
  • - 专业工具：根据不同智能体的需求为其提供相应的工具访问权限。
  • - 独立工作：让子智能体独立工作，然后将结果带回给主智能体。

线程

线程是您与智能体之间的对话。每个线程包含消息、智能体响应以及智能体执行的任何操作。

要查看线程，请在 LangSmith UI中导航至您的智能体。收件箱显示该智能体的所有线程。点击某个线程可查看对话内容。

已读和未读状态

线程的标记方式取决于智能体是否使用频道：

  • 聊天智能体（无频道）： 回复会将线程标记为 **未读**。查看线程会将其标记为已读。
  • 基于频道的智能体： 回复使线程保持 **已读** 状态（默认）。

您可以随时手动将任何线程标记为已读或未读。

工具

工具让智能体与您的应用和服务进行交互。智能体可以发送电子邮件、创建日历事件、发布消息、搜索网页等。您可以从 Gmail、Slack、Google Calendar、GitHub 等众多内置工具中进行选择。

无论智能体通过何种方式触发，工具都能正常工作。例如，您可以在 Fleet 聊天界面中启动一个任务，并让智能体在任务完成时向您发送 Slack 消息 。

请参阅 工具集成 了解更多信息。

追踪

追踪是智能体从输入到输出所执行的一系列步骤。您可以使用 LangSmith 来可视化这些执行步骤。

要查看智能体的所有追踪记录：

  1. 在 LangSmith UI中，导航至智能体的收件箱。
  2. 在代理名称旁边，点击 **查看代理追踪** icon.

要查看特定线程的追踪：

  1. 在 LangSmith UI中，导航到您代理的收件箱。
  2. 右键点击您想要追踪的线程，然后选择 **查看追踪**.

更多信息，请参阅 LangSmith 可观测性.

后续步骤