跳到内容

LangGraph.js CLI

LangGraph.js CLI 是一个多平台命令行工具,用于在本地构建和运行 LangGraph.js API 服务器。它为在所有主流操作系统(Linux、Windows、MacOS)上开发和测试代理提供了一种替代 LangGraph Studio 桌面应用程序的方案。生成的服务器包含用于您的图的运行、线程、助手等的所有 API 端点,以及运行您的代理所需的其他服务,包括用于检查点和存储的托管数据库。

安装

LangGraph.js CLI 可以从 NPM 注册表安装

npx @langchain/langgraph-cli
npm install @langchain/langgraph-cli
yarn add @langchain/langgraph-cli
pnpm add @langchain/langgraph-cli
bun add @langchain/langgraph-cli

命令

CLI 提供了以下核心功能

build

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

dev

langgraph dev 命令启动一个轻量级的开发服务器,该服务器不需要安装 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 时反映出来。