尚拙
Search K

Appearance

LangSmith Studio ​

在本地使用 LangChain 构建智能体时，直观地可视化智能体内部的运行过程、与之进行实时交互，并在问题发生时即时调试是非常有帮助的。LangSmith Studio 是一个免费的可视化界面，用于在本地机器上开发和测试你的 LangChain 智能体。

Studio 可以连接到你本地运行的智能体，向你展示智能体执行的每一步：发送给模型的提示词、工具调用及其结果，以及最终输出。你可以测试不同的输入、检查中间状态，并在无需额外编写代码或部署的情况下快速迭代智能体的行为。

本页介绍了如何将 Studio 与你的本地 LangChain 智能体配合使用。

前提条件 ​

在开始之前，请确保你已具备以下条件：

  • LangSmith 账号：在 smith.langchain.com 注册（免费）或登录。
  • LangSmith API 密钥：参考创建 API 密钥指南进行获取。
  • 如果你不想将数据追踪到 LangSmith，请在应用程序的 .env 文件中设置 LANGSMITH_TRACING=false。禁用追踪后，任何数据都不会离开你的本地服务器。

搭建本地智能体服务器 ​

1. 安装 LangGraph CLI ​

LangGraph CLI 提供了一个本地开发服务器（也称为智能体服务器 (Agent Server)），用于将你的智能体连接到 Studio。

shell
npx @langchain/langgraph-cli

2. 准备你的智能体 ​

如果你已经有了一个 LangChain 智能体，可以直接使用它。本示例使用了一个简单的邮件发送智能体：

title="agent.ts"
typescript
import { createAgent } from "@langchain/agents";

function sendEmail(to: string, subject: string, body: string): string {
  const email = {
    to,
    subject,
    body,
  };
  // ... 邮件发送逻辑

  return `Email sent to ${to}`;
}

const agent = createAgent({
  model: "gpt-5.5",
  tools: [sendEmail],
  systemPrompt: "You are an email assistant. Always use the send_email tool.",
});

3. 环境变量 ​

Studio 需要 LangSmith API 密钥来连接你的本地智能体。在项目的根目录下创建一个 .env 文件，并添加从 LangSmith 获取的 API 密钥。

WARNING

请确保你的 .env 文件不会被提交到版本控制系统（如 Git）中。

.env
bash
LANGSMITH_API_KEY=lsv2...

4. 创建 LangGraph 配置文件 ​

LangGraph CLI 使用配置文件来定位你的智能体并管理依赖项。在应用程序目录下创建一个 langgraph.json 文件：

title="langgraph.json"
json
{
  "dependencies": ["."],
  "graphs": {
    "agent": "./src/agent.ts:agent"
  },
  "env": ".env"
}

createAgent 函数会自动返回一个编译好的 LangGraph 图，这正是配置文件中 graphs 键所期望的内容。

NOTE

有关配置文件 JSON 对象中每个键的详细说明，请参阅 LangGraph 配置文件参考。

此时，项目结构如下所示：

bash
my-app/
├── src
│   └── agent.ts
├── .env
└── langgraph.json

5. 安装依赖 ​

shell
yarn install

6. 在 Studio 中查看你的智能体 ​

启动开发服务器以将你的智能体连接到 Studio：

shell
npx @langchain/langgraph-cli dev

WARNING

Safari 浏览器会阻止从 localhost 连接到 Studio。要解决此问题，请在运行上述命令时加上 --tunnel 参数，通过安全隧道访问 Studio。

服务器运行后，你可以通过 http://127.0.0.1:2024 的 API 以及访问 https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024 的 Studio UI 来访问你的智能体：

Studio UI 中的智能体视图

在 Studio 连接到本地智能体后，你可以快速迭代智能体的行为。运行测试输入，检查包括提示词、工具参数、返回值以及 Token/延迟指标在内的完整执行追踪。当发生错误时，Studio 会捕获异常及其上下文状态，帮助你了解发生了什么。

开发服务器支持热重载——在代码中修改提示词或工具签名，Studio 会立即体现这些更改。可以从任意步骤重新运行对话线程，无需从头开始即可测试你的修改。该工作流程既适用于简单的单工具智能体，也支持扩展到复杂的多节点图。

有关如何运行 Studio 的更多信息，请参阅 LangSmith 文档中的以下指南：

视频指南 ​

Studio

TIP

有关已部署智能体的更多信息，请参阅部署。