快速入门

前提条件

LangGraph Studio 概述

LangGraph Studio 支持连接两种类型的图：

部署在 LangGraph 平台上的图
通过 LangGraph Server 本地运行的图。

LangGraph Studio 可通过 LangSmith UI，在 LangGraph 平台的“部署”选项卡中访问。

已部署的应用程序¶

对于在 LangGraph 平台上部署的应用程序，您可以作为该部署的一部分访问 Studio。为此，请在 LangSmith UI 中导航到 LangGraph 平台中的部署，然后点击“LangGraph Studio”按钮。

这将加载与您的实时部署连接的 Studio UI，允许您创建、读取和更新该部署中的线程、助手和内存。

本地开发服务器¶

使用 LangGraph Studio 测试你本地运行的应用程序，请确保你的应用程序按照此指南设置。

LangSmith 追踪

在本地开发中，如果你不希望将数据追踪到 LangSmith，请在你的应用程序的 .env 文件中设置 LANGSMITH_TRACING=false。禁用追踪后，不会有任何数据离开你的本地服务器。

接下来，安装 LangGraph CLI：

pip install -U "langgraph-cli[inmem]"

然后运行：

langgraph dev

浏览器兼容性

Safari 会阻止对 Studio 的 localhost 连接。为了解决这个问题，请使用 --tunnel 参数运行上面的命令，通过安全隧道访问 Studio。

这将本地启动 LangGraph Server，并在内存中运行。服务器将在监视模式下运行，监听代码更改并自动重新启动。阅读此参考文档，了解所有启动 API 服务器的选项。

如果成功，你将看到以下日志：

准备就绪！

API: http://localhost:2024

文档：http://localhost:2024/docs

LangGraph Studio Web 界面：https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024

一旦运行，你将自动被引导至 LangGraph Studio。

对于已经运行的服务器，可以通过以下方式访问 Studio：

直接导航到以下 URL：https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024。
在 LangSmith 中，导航到 LangGraph 平台部署标签页，点击“LangGraph Studio”按钮，输入 http://127.0.0.1:2024 并点击“连接”。

如果你的服务器运行在不同的主机或端口上，只需更新 baseUrl 以匹配即可。

(可选) 附加调试器¶

进行逐步调试（包括断点和变量检查）：

# 安装 debugpy 包
pip install debugpy

# 启动带有调试功能的服务器
langgraph dev --debug-port 5678

然后附加你喜欢的调试器：

VS Code

将以下配置添加到 launch.json： json { "name": "Attach to LangGraph", "type": "debugpy", "request": "attach", "connect": { "host": "0.0.0.0", "port": 5678 } } 指定你在上一步中选择的端口号。

=== "PyCharm" 1. 转到 Run → Edit Configurations 2. 点击 + 并选择 "Python Debug Server" 3. 设置 IDE 主机名：localhost 4. 设置端口：5678（或你在上一步中选择的端口号）5. 点击 "OK" 并开始调试

故障排除¶

对于入门问题，请参阅此故障排除指南。

下一步¶

有关如何使用 Studio 的更多信息，请参阅以下指南：