应用程序结构¶
概述¶
一个 LangGraph 应用程序包含一个或多个图、一个配置文件(langgraph.json
)、一个指定依赖项的文件,以及一个可选的 .env
文件(用于指定环境变量)。
本指南展示了应用程序的典型结构,并说明了如何指定使用 LangGraph 平台部署应用程序所需的信息。
关键概念¶
要使用 LangGraph 平台部署,应提供以下信息:
- 一个 LangGraph 配置文件(
langgraph.json
),用于指定应用程序要使用的依赖项、图和环境变量。 - 实现应用程序逻辑的图。
- 一个指定运行应用程序所需的依赖项的文件。
- 应用程序运行所需的环境变量。
文件结构¶
以下是 Python 和 JavaScript 应用程序的目录结构示例:
my-app/
├── my_agent # all project code lies within here
│ ├── utils # utilities for your graph
│ │ ├── __init__.py
│ │ ├── tools.py # tools for your graph
│ │ ├── nodes.py # node functions for you graph
│ │ └── state.py # state definition of your graph
│ ├── __init__.py
│ └── agent.py # code for constructing your graph
├── .env # environment variables
├── requirements.txt # package dependencies
└── langgraph.json # configuration file for LangGraph
my-app/
├── my_agent # all project code lies within here
│ ├── utils # utilities for your graph
│ │ ├── __init__.py
│ │ ├── tools.py # tools for your graph
│ │ ├── nodes.py # node functions for you graph
│ │ └── state.py # state definition of your graph
│ ├── __init__.py
│ └── agent.py # code for constructing your graph
├── .env # environment variables
├── langgraph.json # configuration file for LangGraph
└── pyproject.toml # dependencies for your project
my-app/
├── src # all project code lies within here
│ ├── utils # optional utilities for your graph
│ │ ├── tools.ts # tools for your graph
│ │ ├── nodes.ts # node functions for you graph
│ │ └── state.ts # state definition of your graph
│ └── agent.ts # code for constructing your graph
├── package.json # package dependencies
├── .env # environment variables
└── langgraph.json # configuration file for LangGraph
注意
LangGraph 应用程序的目录结构可能因所使用的编程语言和包管理器而异。
配置文件¶
langgraph.json
文件是一个 JSON 文件,用于指定部署 LangGraph 应用程序所需的依赖项、图、环境变量和其他设置。
有关 JSON 文件中所有支持键的详细信息,请参阅 LangGraph 配置文件参考。
提示
LangGraph CLI 默认使用当前目录中的配置文件 langgraph.json
。
示例¶
- 依赖项包括一个自定义本地包和
langchain_openai
包。 - 将从文件
./your_package/your_file.py
中加载一个图,其中包含变量variable
。 - 环境变量从
.env
文件中加载。
依赖项¶
LangGraph 应用程序可能依赖于其他 Python 包或 JavaScript 库(取决于应用程序是用哪种编程语言编写的)。
通常,您需要指定以下信息才能正确设置依赖项:
- 目录中指定依赖项的文件(例如
requirements.txt
、pyproject.toml
或package.json
)。 - LangGraph 配置文件中的
dependencies
键,用于指定运行 LangGraph 应用程序所需的依赖项。 - 任何额外的二进制文件或系统库都可以使用 LangGraph 配置文件中的
dockerfile_lines
键来指定。
图¶
使用 LangGraph 配置文件中的 graphs
键来指定部署的 LangGraph 应用程序中将有哪些图可用。
您可以在配置文件中指定一个或多个图。每个图都由一个名称(应是唯一的)和一个路径标识,该路径可以是:(1) 编译后的图,或 (2) 定义图的函数。
环境变量¶
如果您正在本地使用已部署的 LangGraph 应用程序,可以在 LangGraph 配置文件的 env
键中配置环境变量。
对于生产部署,您通常会希望在部署环境中配置环境变量。