LangSmith Studio
在本地使用 LangChain 构建智能体时,可视化智能体内部发生的事情、实时与其交互以及调试问题非常有帮助。LangSmith Studio 是一个免费的可视化界面,用于从本地机器开发和测试你的 LangChain 智能体。
Studio 连接到你本地运行的智能体,显示智能体执行的每个步骤:发送给模型的提示、工具调用及其结果,以及最终输出。你可以测试不同的输入、检查中间状态,并在不需要额外代码或部署的情况下迭代智能体的行为。
本页描述如何使用本地 LangChain 智能体设置 Studio。
先决条件
开始之前,请确保你具备以下条件:
- LangSmith 账户:在 smith.langchain.com 免费注册或登录
- LangSmith API 密钥:按照创建 API 密钥指南操作
- 如果你不希望数据被追踪到 LangSmith,在应用的
.env文件中设置LANGSMITH_TRACING=false。禁用追踪后,不会有数据离开你的本地服务器
设置本地智能体服务器
1. 安装 LangGraph CLI
LangGraph CLI 提供了一个本地开发服务器(也称为智能体服务器),用于将你的智能体连接到 Studio。
# 需要 Python >= 3.11
pip install --upgrade "langgraph-cli[inmem]"
2. 创建 langgraph.json 配置
在项目根目录创建一个 langgraph.json 配置文件:
{
"node_version": "20",
"dockerfile_lines": [],
"dependencies": ["."],
"graphs": {
"agent": "./src/agent.ts:agent"
}
}
3. 导出你的智能体
确保你的智能体从指定的文件中导出:
// src/agent.ts
import { createAgent } from "langchain";
export const agent = createAgent({
model: "gpt-4o",
tools: [],
prompt: "你是一个有帮助的助手。",
});
4. 启动服务器
langgraph dev
服务器启动后,你可以在终端中看到一个 URL,打开该 URL 即可访问 Studio。
使用 Studio
Studio 提供以下功能:
- 可视化执行 - 查看智能体执行的每个步骤
- 实时交互 - 与运行中的智能体实时对话
- 调试 - 检查提示、工具调用和响应
- 状态检查 - 查看和编辑智能体状态
- 时间旅行 - 回到之前的状态并重新执行
配置选项
langgraph.json 支持以下配置:
- node_version - Node.js 版本
- dependencies - 项目依赖路径
- graphs - 智能体图的映射,格式为
"名称": "路径:导出名" - env - 环境变量文件路径(默认
.env)