跳转至

Quick start

先决条件

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 会阻止到 Studio 的 localhost 连接。要解决此问题,请使用 --tunnel 运行上述命令,以通过安全隧道访问 Studio。

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

如果成功,你将看到以下日志:

Ready!

  • API: http://localhost:2024

  • Docs: http://localhost:2024/docs

  • LangGraph Studio Web UI: https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024

运行后,你将自动被引导到 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 并点击"Connect"。

如果在不同的主机或端口上运行服务器,只需更新 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. 转到 Run → Edit Configurations
  2. 点击 + 并选择 "Python Debug Server"
  3. 设置 IDE host name: localhost
  4. 设置 port: 5678 (或你在上一步中选择的端口号)
  5. 点击 "OK" 并开始调试

故障排除

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

下一步

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