Skip to content

LangGraph 命令行接口(CLI)

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

安装

可以通过Homebrew(适用于macOS)或pip来安装LangGraph CLI:

brew install langgraph-cli
pip install langgraph-cli

命令

CLI 提供以下核心功能:

build

langgraph build 命令用于构建一个可直接部署的 Docker 镜像,该镜像适用于 LangGraph API 服务器

dev

新版本 0.1.55 引入

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

仅限 Python

目前,CLI 只支持 Python >= 3.11。 对于 JavaScript 的支持即将推出。

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 时将不会反映出来。

相关链接

Comments