如何将本地代理连接到 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 文件。在该文件中，它将找到图的路径并启动它们。然后它将自动连接到云端托管的 Studio。

连接到 Studio 后，浏览器窗口应自动弹出。这将使用云端托管的 Studio UI 连接到您的本地开发服务器。您的图仍然在本地运行，UI 连接到用于可视化本地定义的代理和线程。

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

用于使用断点和变量检查进行逐步调试

# Install debugpy package
pip install debugpy

# Start server with debugging enabled
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
  }
}

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