跳到内容

LangGraph CLI

先决条件

LangGraph CLI 是一个多平台命令行工具，用于在本地构建和运行LangGraph API 服务器。生成的服务器包含您的图（graph）的所有运行（run）、线程（thread）、助手（assistant）等的 API 端点，以及运行您的智能体（agent）所需的其他服务，包括用于检查点（checkpointing）和存储的托管数据库。

安装

LangGraph CLI 可以通过 Homebrew（在 macOS 上）或 pip 安装

brew install langgraph-cli

pip install langgraph-cli

命令

CLI 提供以下核心功能

build

langgraph build 命令为LangGraph API 服务器构建一个 Docker 镜像，可以直接部署。

dev

0.1.55 版本新增

langgraph dev 命令是在 langgraph-cli 0.1.55 版本中引入的。

仅限 Python

目前，CLI 仅支持 Python >= 3.11。JS 支持即将推出。

langgraph dev 命令启动一个轻量级的开发服务器，无需安装 Docker。该服务器非常适合快速开发和测试，具有以下功能：

  • 热重载：自动检测并重新加载您的代码更改
  • 调试器支持：连接您的 IDE 调试器进行逐行调试
  • 内存状态，本地持久化：服务器状态存储在内存中以提高速度，但在重新启动之间在本地持久化

要使用此命令，您需要通过 "inmem" extra 来安装 CLI

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

注意：此命令仅用于本地开发和测试。不建议用于生产环境。由于它不使用 Docker，我们建议使用虚拟环境来管理您的项目依赖项。

up

langgraph up 命令在本地 Docker 容器中启动一个 LangGraph API 服务器实例。这需要本地运行 Docker 服务器。它还需要 LangSmith API 密钥用于本地开发或许可证密钥用于生产环境。

该服务器包含您的图（graph）的所有运行（run）、线程（thread）、助手（assistant）等的 API 端点，以及运行您的智能体（agent）所需的其他服务，包括用于检查点（checkpointing）和存储的托管数据库。

dockerfile

langgraph dockerfile 命令生成一个 Dockerfile，可用于构建LangGraph API 服务器的镜像并部署其实例。如果您想进一步自定义 dockerfile 或以更自定义的方式部署，这将非常有用。

更新您的 langgraph.json 文件

langgraph dockerfile 命令将您的 langgraph.json 文件中的所有配置转换为 Dockerfile 命令。使用此命令时，每当您更新 langgraph.json 文件，您都需要重新运行它。否则，当您构建或运行 dockerfile 时，您的更改将不会反映出来。

评论