跳到内容

LangGraph CLI

先决条件

LangGraph CLI 是一个多平台命令行工具，用于本地构建和运行 LangGraph API 服务器。生成的服务器包含用于你的图运行、线程、助手等的所有 API 端点，以及运行你的代理所需的其他服务，包括用于检查点和存储的托管数据库。

安装

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" 额外选项安装 CLI

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

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

up

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

该服务器包含用于你的图运行、线程、助手等的所有 API 端点，以及运行你的代理所需的其他服务，包括用于检查点和存储的托管数据库。

dockerfile

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

更新你的 langgraph.json 文件

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

评论