在使用 LangChain 在本地构建智能体时,可视化智能体内部的工作流程、实时交互以及调试出现的问题非常有帮助。LangSmith Studio 是一个免费的可视化界面,用于在您的本地机器上开发和测试 LangChain 智能体。 Studio 连接到您本地运行的智能体,向您展示智能体采取的每个步骤:发送给模型的提示词、工具调用及其结果,以及最终的输出。您可以测试不同的输入,检查中间状态,并在无需额外代码或部署的情况下迭代调整智能体的行为。 本页将介绍如何将 Studio 与您的本地 LangChain 智能体进行设置。

前提条件

开始之前,请确保您已具备以下条件:
  • LangSmith 账户:在 smith.langchain.com 免费注册或登录。
  • LangSmith API 密钥:请参阅 创建 API 密钥 指南。
  • 如果您不想将数据追踪到 LangSmith,请在您应用程序的 .env 文件中设置 LANGSMITH_TRACING=false。禁用追踪后,不会有任何数据离开您的本地服务器。

设置本地智能体服务器

1. 安装 LangGraph CLI

LangGraph CLI 提供了一个本地开发服务器(也称为智能体服务器),用于将您的智能体连接到 Studio。

2. 准备您的智能体

如果您已经有一个 LangChain 智能体,可以直接使用它。本示例使用一个简单的邮件智能体:
agent.ts

3. 环境变量

Studio 需要一个 LangSmith API 密钥来连接您的本地智能体。在项目根目录创建一个 .env 文件,并从 LangSmith 添加您的 API 密钥。
请确保您的 .env 文件未被提交到版本控制系统(例如 Git)。
.env

4. 创建 LangGraph 配置文件

LangGraph CLI 使用配置文件来定位您的智能体并管理依赖项。在您的应用目录中创建一个 langgraph.json 文件:
langgraph.json
createAgent 函数会自动返回一个编译好的 LangGraph 图,这正是配置文件中 graphs 键所期望的内容。
有关配置文件中 JSON 对象每个键的详细解释,请参阅 LangGraph 配置文件参考。
此时,项目结构将如下所示:

5. 安装依赖项

6. 在 Studio 中查看您的智能体

启动开发服务器以将您的智能体连接到 Studio:
Safari 浏览器会阻止连接到 Studio 的 localhost 请求。要解决此问题,请使用 --tunnel 参数运行上述命令,通过安全隧道访问 Studio。
服务器运行后,您的智能体可通过 API(地址为 http://127.0.0.1:2024)以及 Studio UI(地址为 https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024)进行访问:
Studio UI 中的智能体视图
将 Studio 连接到您的本地智能体后,您可以快速迭代调整智能体的行为。运行一个测试输入,检查完整的执行追踪,包括提示词、工具参数、返回值以及令牌数/延迟指标。当出现错误时,Studio 会捕获异常及其上下文状态,帮助您理解发生了什么。 开发服务器支持热重载——在代码中修改提示词或工具签名后,Studio 会立即反映这些更改。您可以从任何步骤重新运行对话线程来测试您的更改,无需从头开始。此工作流程可扩展应用于从简单的单工具智能体到复杂的多节点图。 有关如何运行 Studio 的更多信息,请参阅 LangSmith 文档中的以下指南:

视频指南

有关已部署代理的更多信息,请参阅部署。