Skip to main content

​
概述

LangGraph 应用由一个或多个图（graphs）、一个配置文件（langgraph.json）、一个用于声明依赖项的文件，以及一个可选的 .env 文件（用于指定环境变量）组成。 本指南展示了一个典型的应用结构，并说明如何通过 LangGraph 平台部署应用时指定所需的信息。

​
核心概念

使用 LangGraph 平台进行部署时，需提供以下信息：
  1. 一个 LangGraph 配置文件（langgraph.json），用于指定应用所依赖的包、图结构和环境变量。
  2. 实现应用逻辑的 图结构。
  3. 一个声明运行应用所需 依赖项 的文件。
  4. 应用运行所需的 环境变量。

​
文件结构

以下是应用目录结构的示例：
  • Python (requirements.txt)
  • Python (pyproject.toml)
my-app/
├── my_agent # 所有项目代码位于此目录下
│   ├── utils # 图结构相关工具函数
│   │   ├── __init__.py
│   │   ├── tools.py # 图结构所用工具
│   │   ├── nodes.py # 图结构节点函数
│   │   └── state.py # 图结构状态定义
│   ├── __init__.py
│   └── agent.py # 构建图结构的代码
├── .env # 环境变量
├── requirements.txt # 包依赖
└── langgraph.json # LangGraph 配置文件
LangGraph 应用的目录结构可根据所使用的编程语言和包管理器有所不同。

​
配置文件

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

​
示例

  • 依赖项包括一个自定义本地包和 langchain_openai 包。
  • 从文件 ./your_package/your_file.py 中加载一个图，变量名为 agent。
  • 环境变量从 .env 文件加载。
{
  "dependencies": ["langchain_openai", "./your_package"],
  "graphs": {
    "my_agent": "./your_package/your_file.py:agent"
  },
  "env": "./.env"
}

​
依赖项

LangGraph 应用可能依赖于其他 Python 包。 通常需要指定以下信息以正确设置依赖项：
  1. 目录中指定依赖项的文件（例如 requirements.txt、pyproject.toml 或 package.json）。
  2. 在 LangGraph 配置文件 中的 dependencies 字段，指定运行 LangGraph 应用所需的依赖项。
  3. 任何额外的二进制文件或系统库，可通过 LangGraph 配置文件 中的 dockerfile_lines 字段指定。

​
图结构

使用 LangGraph 配置文件 中的 graphs 字段，指定部署后的 LangGraph 应用中可用的图结构。 您可以在配置文件中指定一个或多个图。每个图由一个唯一名称标识，并指定其来源路径，路径可以指向：(1) 已编译的图对象，或 (2) 用于构建图的函数。

​
环境变量

如果您在本地开发并运行已部署的 LangGraph 应用，可以在 LangGraph 配置文件 的 env 字段中配置环境变量。 对于生产环境部署，通常应在部署环境中配置环境变量。