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

本指南将指导您如何将本地代理连接到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 文件。在该文件中，它将找到图的路径，并启动这些图。然后它会自动连接到云端托管的工作室。

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

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

对于带有断点和变量检查的逐步调试：

# 安装debugpy包
pip install debugpy

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

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

VS CodePyCharm

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

{
  "name": "附加到LangGraph",
  "type": "debugpy",
  "request": "attach",
  "connect": {
    "host": "0.0.0.0",
    "port": 5678
  }
}

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