如何将本地代理连接到 LangGraph Studio¶

本指南将向您展示如何使用开发服务器将本地代理连接到 LangGraph Studio，以进行可视化、交互和调试。

配置你的应用程序¶

首先，你需要以正确的格式配置你的应用程序。这意味着要定义一个 langgraph.json 文件，其中包含指向你的代理的路径。有关如何操作的信息，请参阅本指南。

你需要安装 langgraph-cli（版本 0.1.55 或更高）。你需要确保安装 inmem 额外组件。

最低版本

使用 langgraph-cli 的 inmem 额外组件的最低版本是 0.1.55。需要 Python 3.11 或更高版本。

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

这将在你当前的目录中查找 langgraph.json 文件。在该文件中，它会找到图（graph）的路径，并启动这些图。然后，它会自动连接到云端托管的工作室。

连接到工作室后，浏览器窗口应会自动弹出。这将使用云端托管的工作室用户界面（UI）连接到您的本地开发服务器。您的图仍然在本地运行，UI 连接到本地定义的代理和线程以进行可视化展示。

图将始终使用最新的代码，因此您可以更改底层代码，并使其在工作室中自动更新。这对于调试工作流非常有用。您可以在 UI 中运行您的图，直到出现问题，然后进入并更改您的代码，接着从失败的节点重新运行。

若要使用断点和变量检查进行逐行调试，请执行以下操作：

# 安装 debugpy 包
pip install debugpy

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

然后附加您首选的调试器：

VS CodePyCharm

将以下配置添加到 launch.json 中：

{
  "name": "Attach to LangGraph",
  "type": "debugpy",
  "request": "attach",
  "connect": {
    "host": "0.0.0.0",
    "port": 5678
  }
}

指定您在上一步中选择的端口号。