如何将本地 Agent 连接到 LangGraph Studio¶

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

设置您的应用程序¶

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

您需要安装 langgraph-cli（版本 0.1.55 或更高版本）。您需要确保安装 inmem 扩展。

最低版本

使用 inmem 扩展和 langgraph-cli 的最低版本是 0.1.55。需要 Python 3.11 或更高版本。

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

这将查找您当前目录中的 langgraph.json 文件。在其中，它将找到指向 graph 的路径，并启动它们。然后它将自动连接到云托管的 Studio。

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

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

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

# 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
  }
}

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