跳到内容

快速入门

先决条件

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

LangGraph Studio 可从 LangSmith UI 的 LangGraph Platform Deployments 选项卡中访问。

已部署的应用

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

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

本地开发服务器

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

LangSmith 追踪

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

接下来，安装 LangGraph CLI

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

并运行

langgraph dev

浏览器兼容性

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

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

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

准备就绪！

运行后，您将自动跳转到 LangGraph Studio。

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

  1. 直接导航到以下 URL：https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024。
  2. 在 LangSmith 中，导航到 LangGraph Platform Deployments 选项卡，点击“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

然后附加您偏好的调试器

将此配置添加到 launch.json

{
    "name": "Attach to LangGraph",
    "type": "debugpy",
    "request": "attach",
    "connect": {
      "host": "0.0.0.0",
      "port": 5678
    }
}
  1. 前往运行 → 编辑配置
  2. 点击 + 并选择“Python 调试服务器”
  3. 设置 IDE 主机名: localhost
  4. 设置端口: 5678 (或您在上一步中选择的端口号)
  5. 点击“确定”并开始调试

故障排除

如果遇到启动问题，请参阅此故障排除指南。

下一步

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