快速入门

先决条件

LangGraph Studio 概述

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

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

可在 LangSmith 用户界面中通过 LangGraph 平台部署选项卡访问 LangGraph Studio。

已部署应用程序¶

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

这将加载连接到您的实时部署的 Studio 用户界面，使您能够在该部署中创建、读取和更新线程、助手和记忆。

本地开发服务器¶

要使用 LangGraph Studio 测试您在本地运行的应用程序，请确保您的应用程序已按照本指南进行设置。

LangSmith 追踪

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

接下来，安装 LangGraph CLI

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

并运行

langgraph dev

浏览器兼容性

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

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

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

就绪！

API: http://localhost:2024

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

LangGraph Studio 网页用户界面: 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 以匹配。

(可选) 附加调试器¶

用于带有断点和变量检查的逐步调试

# Install debugpy package
pip install debugpy

# Start server with debugging enabled
langgraph dev --debug-port 5678

然后附加您偏好的调试器

VS Code

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

=== "PyCharm" 1. 转到运行 → 编辑配置 2. 点击 + 并选择“Python 调试服务器” 3. 设置 IDE 主机名: localhost 4. 设置端口: 5678 (或您在上一步中选择的端口号) 5. 点击“确定”并开始调试

故障排除¶

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

下一步¶

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