LangGraph 命令行接口(CLI)¶
LangGraph CLI 是一个多平台命令行工具,用于本地构建和运行 LangGraph API 服务器。生成的服务器包括您图的所有运行、线程、助手等的 API 端点,以及其他运行您的代理所需的服 务,包括一个用于检查点和存储的托管数据库。
安装¶
可以通过Homebrew(适用于macOS)或pip来安装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 进行安装:
注意:此命令仅适用于本地开发和测试,不建议用于生产环境。由于它不使用 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 时将不会反映出来。