一个 LangGraph 应用由一个或多个图、一个配置文件(langgraph.json)、一个指定依赖项的文件以及一个可选的、用于指定环境变量的 .env 文件组成。 本指南展示了应用的典型结构,并向您展示了如何提供必要的配置,以便使用 LangSmith 部署 来部署应用。
LangSmith 部署是一个用于部署和扩展 LangGraph 代理的托管托管平台。它处理基础设施、扩展和运维问题,因此您可以直接从代码仓库部署您有状态的、长时间运行的代理。更多详情请参阅部署文档。

关键概念

要使用 LangSmith 进行部署,应提供以下信息:
  1. 一个 LangGraph 配置文件(langgraph.json),该文件指定了应用要使用的依赖项、图和环境变量。
  2. 实现应用逻辑的 图。
  3. 一个指定运行应用所需 依赖项 的文件。
  4. 应用运行所需的 环境变量。

文件结构

以下是应用的目录结构示例:
LangGraph 应用的目录结构可能因使用的编程语言和包管理器而异。

配置文件

langgraph.json 文件是一个 JSON 文件,它指定了部署 LangGraph 应用所需的依赖项、图、环境变量和其他设置。 有关 JSON 文件中所有支持的键的详细信息,请参阅 LangGraph 配置文件参考。
LangGraph CLI 默认使用当前目录下的配置文件 langgraph.json。

示例

  • 依赖项将从本地目录中的依赖文件(例如 package.json)加载。
  • 单个图将从文件 ./your_package/your_file.js 中加载,使用的函数是 agent。
  • 环境变量 OPENAI_API_KEY 内联设置。

依赖项

一个 LangGraph 应用可能依赖于其他 TypeScript/JavaScript 库。 通常,您需要指定以下信息以正确设置依赖项:
  1. 目录中指定依赖项的文件(例如 package.json)。
  2. LangGraph 配置文件 中的 dependencies 键,用于指定运行 LangGraph 应用所需的依赖项。
  3. 任何额外的二进制文件或系统库可以使用 LangGraph 配置文件 中的 dockerfile_lines 键来指定。

图

使用 LangGraph 配置文件 中的 graphs 键来指定哪些图将在部署的 LangGraph 应用中可用。 您可以在配置文件中指定一个或多个图。每个图由一个名称(应是唯一的)和一个路径标识,该路径指向:(1) 编译后的图 或 (2) 定义图的函数。

环境变量

如果您在本地使用已部署的 LangGraph 应用,可以在 LangGraph 配置文件 的 env 键中配置环境变量。 对于生产部署,您通常需要在部署环境中配置环境变量。