Skip to content

LangGraph 命令行界面

前提条件

LangGraph 命令行界面是一个跨平台的命令行工具，用于在本地构建和运行 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 时，你的更改将不会生效。

相关内容

Comments