Skip to content

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

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

设置您的应用程序

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

安装langgraph-cli

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

最低版本要求

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

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

运行开发服务器

  1. 导航到你的项目目录(包含 langgraph.json 的位置)

  2. 启动服务器:

    langgraph dev
    

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

使用工作室

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

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

(可选)附加调试器

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

# 安装debugpy包
pip install debugpy

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

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

将以下配置添加到launch.json

{
  "name": "附加到LangGraph",
  "type": "debugpy",
  "request": "attach",
  "connect": {
    "host": "0.0.0.0",
    "port": 5678
  }
}
指定上一步中选择的端口号。

  1. 转到运行 → 编辑配置
  2. 点击+并选择“Python调试服务器”
  3. 设置IDE主机名:localhost
  4. 设置端口:5678(或上一步中选择的端口号)
  5. 点击“确定”并开始调试

Comments