Concepts

LangGraph.js CLI

LangGraph.js CLI

:::info[先决条件]

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

安装

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

=== npx

npx @langchain/langgraph-cli

=== npm

npm install @langchain/langgraph-cli

=== yarn

yarn add @langchain/langgraph-cli

=== pnpm

pnpm add @langchain/langgraph-cli

=== bun

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 密钥或用于生产用途的许可证密钥。

该服务器包括图的运行、线程、assistants 等的所有 API 端点,以及运行 agent 所需的其他服务,包括用于检查点和存储的托管数据库。

dockerfile

langgraph dockerfile 命令生成一个 Dockerfile,可用于为 LangGraph API 服务器 的实例构建镜像和部署。如果你希望进一步自定义 dockerfile 或以更自定义的方式部署,这很有用。

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

相关

On this page

On this page