尚拙
Search K

Appearance

LangSmith Studio ​

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

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

本页面介绍了如何为本地 LangChain 智能体设置 Studio。

前置准备 ​

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

  • LangSmith 账户：在 smith.langchain.com 免费注册或登录。
  • LangSmith API 密钥：按照创建 API 密钥指南进行操作。
  • 如果你不希望将数据跟踪到 LangSmith，请在应用程序的 .env 文件中设置 LANGSMITH_TRACING=false。禁用跟踪后，任何数据都不会离开你的本地服务器。

设置本地 Agent Server ​

1. 安装 LangGraph CLI ​

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

shell
npx @langchain/langgraph-cli

2. 准备你的智能体 ​

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

typescript
// agent.ts
import { createAgent } from "@langchain/langgraph";

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

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

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

export { agent };

3. 环境变量 ​

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

WARNING

确保你的 .env 文件未提交到版本控制系统（如 Git）。

bash
LANGSMITH_API_KEY=lsv2...

4. 创建 LangGraph 配置文件 ​

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

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

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

INFO

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

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

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

5. 安装依赖项 ​

shell
yarn install

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

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

shell
npx @langchain/langgraph-cli dev

WARNING

Safari 会阻止与 Studio 的 localhost 连接。若要解决此问题，请使用 --tunnel 运行上述命令以通过安全隧道访问 Studio。你需要通过单击 Studio UI 中的 Connect to a local server 手动将隧道 URL 添加到允许的来源。有关步骤，请参阅故障排查指南。

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

Agent view in the Studio UI

将 Studio 连接到本地智能体后，你可以快速迭代智能体的行为。运行测试输入，在 LangSmith 中检查完整的执行跟踪，包括提示词、工具参数、返回值以及 Token/延迟指标。当出现问题时，Studio 会捕获异常以及周围的状态，以帮助你了解发生了什么。

开发服务器支持热重载——在代码中更改提示词或工具签名，Studio 会立即反映它们。从任何步骤重新运行对话线程以测试你的更改，而无需重新开始。此工作流可以从简单的单工具智能体扩展到复杂的多节点图。

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

视频指南 ​

Studio 视频介绍