LangGraph Studio

📚 学习目标

学完这篇文章后，你将能够：

• 使用 Studio 可视化查看图结构
• 在 Studio 中进行断点调试和修改状态
• 利用 Studio 分析 Token 消耗和性能瓶颈

前置知识

在开始学习之前，建议先阅读：

• 01-langgraph-platform

1️⃣ 什么是 Studio?

LangGraph Studio 是一个专用的可视化 IDE。它不是用来写代码的（代码还是在 VS Code 里写），而是用来运行和调试 Agent 的。

想象一下 Chrome DevTools Network 面板 + Redux DevTools，但专门为 AI Agent 设计。

它能展示：

• 实时图结构：看到哪个节点正在亮起（运行）。
• 消息流：右侧聊天窗口实时显示交互。
• 状态快照：左侧面板显示每一步的 State 变化。

2️⃣ 如何使用

本地使用

如果你安装了 LangGraph CLI 和 Docker：

langgraph dev

这会启动一个本地服务，并自动打开 Studio 界面（通常在 http://localhost:2024）。当你修改代码（VS Code）并保存时，Studio 会自动热重载。

[!NOTE] 如果你跑不起来，最常见的原因是：Docker 没启动、端口被占用、CLI 未安装或 Node 版本不匹配。

远程使用

部署到 LangGraph Cloud 后，每个部署都有一个对应的 Studio 链接。你可以用它来调试线上（或 Staging）环境的 Session。

3️⃣ 核心功能

可视化追踪 (Visual Trace)

不用再盯着 console.log 看了。Studio 会把每一步（Token 生成、工具调用、HTTP 请求）画在时间轴上。

交互修改 (Interactive Editing)

你可以：

1. 运行到一半暂停（比如在 human-in-the-loop 断点）。
2. 在 Studio 界面修改 State（比如改掉 LLM 生成的一句话）。
3. 点击 "Continue"，Agent 会带着你修改后的状态继续跑。

这是调试 Prompt 和逻辑的神器。

4️⃣ 常见排障清单

1. 看不到图结构：检查应用是否真的启动、是否导出了 graph/entry。
2. 状态不更新：确认你的节点返回的是“增量更新”，且 reducer 没写错。
3. 无法时间旅行/恢复：确认编译时传入了 checkpointer，并且每次调用都带 thread_id。
4. 工具调用卡死：给工具加超时，或者在 Studio 的 trace 里定位是哪一步耗时。

📚 参考资源

官方文档

• LangGraph JS

💡 练习题

1. 操作题：如果在本地跑不起来 Docker，尝试访问 LangGraph 官网的 Demo Studio，体验一下可视化调试流程。尝试找到 "Thread History" 面板。

✅ 总结

本章要点：

• Studio 是 Agent 开发者的 "IDE"。
• Local Dev：langgraph dev 提供了极致的开发体验。
• Debugging：可视化追踪比日志更直观。

恭喜！ 你已经了解了部署相关的所有知识。