在本地使用 LangChain 构建 Agent 时，可视化 Agent 内部发生的事情、实时交互并在问题出现时进行调试是很有帮助的。LangSmith Studio 是一个免费的视觉界面，用于从本地计算机开发和测试您的 LangChain Agent。
Studio 连接到您本地运行的 Agent，向您显示 Agent 采取的每个步骤：发送到模型的提示、工具调用及其结果，以及最终输出。您可以测试不同的输入、检查中间状态，并迭代您的 Agent 行为，而无需额外的代码或部署。
本页面描述如何使用您的本地 LangChain Agent 设置 Studio。
前置条件
在开始之前，请确保您具备以下条件：
- LangSmith 账户：在 smith.langchain.com 注册（免费）或登录。
- LangSmith API 密钥：按照 创建 API 密钥 指南操作。
- 如果您不希望数据跟踪到 LangSmith，请在您的应用程序的
.env 文件中设置 LANGSMITH_TRACING=false。禁用跟踪后，数据不会离开您的本地服务器。
设置本地 Agent 服务器
1. 安装 LangGraph CLI
LangGraph CLI 提供一个本地开发服务器（也称为 Agent 服务器），将您的 Agent 连接到 Studio。
# 需要 Python >= 3.11。
pip install --upgrade "langgraph-cli[inmem]"
2. 准备您的 Agent
如果您已经有 LangChain Agent，可以直接使用。此示例使用一个简单的电子邮件 Agent：
from langchain.agents import create_agent
def send_email(to: str, subject: str, body: str):
"""发送电子邮件"""
email = {
"to": to,
"subject": subject,
"body": body
}
# ... 电子邮件发送逻辑
return f"Email sent to {to}"
agent = create_agent(
"gpt-4.1",
tools=[send_email],
system_prompt="You are an email assistant. Always use send_email tool.",
)
3. 环境变量
Studio 需要 LangSmith API 密钥来连接您的本地 Agent。在项目根目录中创建 .env 文件并添加您的 LangSmith API 密钥。
确保您的 .env 文件未提交到版本控制（如 Git）。
LANGSMITH_API_KEY=lsv2...
4. 创建 LangGraph 配置文件
LangGraph CLI 使用配置文件来定位您的 Agent 并管理依赖项。在应用程序目录中创建 langgraph.json 文件：
{
"dependencies": ["."],
"graphs": {
"agent": "./src/agent.py:agent"
},
"env": ".env"
}
create_agent 函数自动返回一个编译的 LangGraph 图，这是配置文件中 graphs 键所期望的。
此时，项目结构将如下所示：
my-app/
├── src
│ └── agent.py
├── .env
└── langgraph.json
5. 安装依赖项
从根目录安装项目依赖项：
pip install langchain langchain-openai
6. 在 Studio 中查看您的 Agent
启动开发服务器以将您的 Agent 连接到 Studio：
Safari 阻止与 Studio 的 localhost 连接。要解决此问题，请使用 --tunnel 运行上述命令，通过安全隧道访问 Studio。您需要通过在 Studio UI 中单击连接到本地服务器，手动将隧道 URL 添加到允许的源。有关步骤，请参阅故障排除指南。 http://127.0.0.1:2024 访问，也可以通过 Studio UI 在 https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024 访问：
Studio 连接到您的本地 Agent 后，您可以快速迭代 Agent 的行为。运行测试输入，在 LangSmith 中检查包括提示、工具参数、返回值和令牌/延迟指标在内的完整执行跟踪。当出现问题时，Studio 会捕获带有周围状态的异常，以帮助您了解发生了什么。
开发服务器支持热重载—在代码中更改提示或工具签名，Studio 会立即反映这些更改。从任何步骤重新运行对话线程以测试您的更改，而无需重新开始。此工作流从简单的单工具 Agent 扩展到复杂的多节点图。
有关如何运行 Studio 的更多信息，请参阅 LangSmith 文档中的以下指南：
视频指南
通过 MCP 将这些文档连接到 Claude、VSCode 等以获取实时答案。
