代理图可视化
把用 LangGraph 定义的代理以图的形式呈现出来，让开发者直观看到节点与边的结构。表示可视化有助于开发者理解自己所构建的图。
LangGraph Studio
AI TOOL PROFILE工具资料专为代理开发设计的可视化 IDE，可查看图结构并在运行中途改状态
官网地址 https://blog.langchain.dev/langgraph-studio-the-first-agent-ide/
价格测试期间 LangSmith 免费账号即可使用
平台桌面端（Apple Silicon）
归类AI 编程
收录2024-08-01
复核2024-08-01
编辑评分
4.2 / 5
★★★★☆
LangGraph Studio编辑总结
LangGraph Studio 是 LangChain 团队于 2024 年 8 月 1 日发布公开测试版的代理开发 IDE，其为首个专为代理开发打造的 IDE。它以桌面应用形式提供，当前仅支持 Apple Silicon，用 LangSmith 账号登录即可使用，免费账号也能用。核心能力是把 LangGraph 代理的图结构可视化，并允许在代理执行到一半时修改结果或某个节点的底层逻辑，从而形成可反复调试的迭代流程。它与代码编辑器是互补关系而非替代：生产级 LangGraph 应用节点与边里的自定义逻辑依然要靠写代码完成。目前仅支持 Apple Silicon 这一种平台，其他平台尚未开放。
LangGraph Studio是什么？
LangGraph Studio 由 LangChain 团队开发，定位是代理（agent）开发专用的 IDE，2024 年 8 月 1 日以公开测试版形式发布。它服务的是用 LangGraph 构建 LLM 应用的开发者，尤其是那些应用结构复杂、超过单次 LLM 调用、需要高度领域化认知架构的团队。
LangGraph 本身是 2023 年 1 月推出的低层编排框架，强调可控性与自主性的平衡，带持久化层以支持 human-in-the-loop，已开源并提供 Python 与 JavaScript 两个版本，可搭配也可不搭配 LangChain，同时能与 LangSmith 无缝集成。LangGraph Studio 是这个框架之上的开发工具，不是替代品。
实际使用时，开发者仍然主要在代码里工作：先把图定义在 Python 文件中，再准备一个 langgraph.json 描述代理定义位置、要安装的依赖和要加载的环境变量，然后在 Studio 里打开该目录。工具会为代理构建运行环境，构建完成后呈现图的可视化结果。桌面端当前支持 Apple Silicon，登录用 LangSmith 账号。
LangGraph Studio核心功能
中途修改运行状态
可以在代理轨迹执行到一半时修改代理结果，或改动某个具体节点背后的逻辑。改完继续往下跑，从而观察不同分支下的表现。
迭代式调试流程
通过在任意时间点介入并操纵状态，把「跑一次、改一处、再跑一次」变成可重复的循环，这让开发过程更具迭代性。
目录即项目
登录后直接打开一个目录即可，最低要求是该目录里含有一个定义了图的 Python 文件；langgraph.json 可以在界面里创建，也可以提前放在目录中。
自动构建运行环境
打开目录后，工具会为代理构建运行环境，构建完成后进入图的可视化界面。依赖与环境变量由 langgraph.json 指定。
LangSmith 账号接入
打开应用后先用 LangSmith 账号登录，测试期间所有 LangSmith 用户均可使用，免费账号也在内。LangGraph 本身也与 LangSmith 无缝集成。
LangGraph Studio值不值得用？
用来调试结构复杂的 LangGraph 代理时，LangGraph Studio 解决的是真实痛点：代理跑起来像黑盒，图结构看不清、中途出错只能重跑。它把图摊开给你看，还允许在轨迹中途改结果或改节点逻辑，调试效率比反复读日志高。当你只是写一个简单的单次 LLM 调用，或者根本不用 LangGraph，这套工具就没有用武之地——官方也明确说它是代码编辑器的补充而不是替代。另一个现实约束是平台：当前只有 Apple Silicon 桌面版，用别的设备就暂时用不上。
建议选它的情况
- 用 LangGraph 构建生产级代理，图里有大量自定义节点和边的逻辑
- 代理行为不稳定，需要反复在中途介入、改状态再继续跑
- 团队已经在用 LangSmith，登录即可直接上手，无需额外配置账号体系
不建议选它的情况
- 用 Apple Silicon 之外的设备，目前没有可用的客户端
- 应用只是单次 LLM 调用，或压根不用 LangGraph 构建
LangGraph Studio使用建议
入门先把路子走对
- 先备好目录目录里至少要有一个定义了图的 Python 文件，否则打开后没有可运行的对象。可以参照官方给出的示例仓库来对照目录结构。
- 写 langgraph.json在里面交代代理定义在哪里、要装哪些依赖、要加载哪些环境变量。这个文件既能在界面里现建，也可以事先放进目录。
- 用 LangSmith 登录下载并打开应用后会提示登录 LangSmith 账号。测试期间免费账号同样可以使用，不需要额外开通付费。
进阶省时间也省钱
- 卡住时改节点逻辑代理走到某个节点行为不对，不必停下重跑：直接改这个节点背后的逻辑，再让它沿当前轨迹继续，能更快定位是节点本身还是上游状态的问题。
- 按轨迹分段验证把长轨迹拆成几段，在每段交接处检查状态是否符合预期。这样出问题时能确定是哪一段引入的偏差，而不是从头猜。
LangGraph Studio适合谁用？
LangGraph 代理开发者
推荐正在用 LangGraph 构建复杂代理，图里有较多自定义节点和边逻辑，需要看清结构并频繁调试。
已用 LangSmith 的团队
推荐账号体系现成，打开应用登录即可用，测试期间免费账号也能进入，接入成本低。
Apple Silicon 用户
推荐目前桌面端只提供 Apple Silicon 版本，手上有对应设备才能直接下载使用。
Windows 或 Intel Mac 用户
不推荐当前没有对应平台的客户端，更多平台支持还在路上，现阶段用不上。
只做单次 LLM 调用的开发者
有条件应用结构简单、没有多步代理轨迹需要干预时，这套可视化与中途改状态的能力用不到。
LangGraph Studio优点和缺点
优点
- 是首个专为代理开发设计的 IDE，2024 年 8 月 1 日进入公开测试
- 可把代理图结构可视化，帮助开发者理解自己定义的节点与边
- 支持在代理执行中途修改结果或某个节点的底层逻辑
- 测试期间所有 LangSmith 用户可用，免费账号同样开放
- 打开目录即可自动构建运行环境，不需要手动搭调试环境
- 与代码编辑器互补，保留生产级自定义逻辑的编写方式
缺点
- 桌面端目前只支持 Apple Silicon，其他平台尚未提供
- 必须先有一个含图的 Python 文件与 langgraph.json 才能启动
- 功能仍处于公开测试阶段，还有大量能力待探索
- 不面向非 LangGraph 项目，脱离该框架就没有使用场景
LangGraph Studio常见问题
LangGraph Studio 要花钱吗？＋
测试期间不需要额外付费。官方说明所有 LangSmith 用户都能使用，包括免费账号在内，用它只需要一个 LangSmith 账号登录即可。
现在是什么版本，正式版了吗？＋
不是正式版。官方在 2024 年 8 月 1 日以公开测试版（open beta）的形式发布，并表示只是把代理 IDE 的部分核心能力先带出来，还有更多内容待探索。
它和我平时用的代码编辑器是什么关系？＋
是补充关系，不是替代。官方明确说不打算取代代码编辑器，因为生产级 LangGraph 应用的节点和边里有复杂的自定义逻辑，写代码仍不可少；Studio 做的是把图可视化和中途干预的能力补上。
在 Windows 或 Intel Mac 上能用吗？＋
目前不行。桌面应用当前仅提供 Apple Silicon 版本，更多平台的支持即将推出，但未给出具体时间。
用之前需要准备什么？＋
需要一个目录，里面至少有一个定义了图的 Python 文件；再准备一个 langgraph.json，写明代理定义位置、要安装的依赖和要加载的环境变量。这个配置文件可以在界面里创建，也可以事先放好。
和 LangSmith 是什么关系？＋
两者可以配合使用。LangGraph 本身与 LangSmith 无缝集成，而 Studio 要求用 LangSmith 账号登录，测试期间 LangSmith 的所有用户（含免费账号）都能访问 Studio。
LangGraph Studio最新动态
-
LangGraph Studio 公开测试版发布
LangChain 团队发布 LangGraph Studio，其为首个专为代理开发设计的 IDE，以公开测试版形式提供。
-
LangGraph 0.1 稳定版
此前对 LangGraph 投入大量资源，于 2024 年 6 月发布 0.1 稳定版本。
-
LangGraph 发布
2023 年 1 月推出 LangGraph，定位为高度可控的低层编排框架，用于构建代理应用。
