应用程序结构

概述

一个LangGraph应用程序由一个或多个图、一个配置文件（langgraph.json）、一个指定依赖关系的文件以及一个可选的指定环境变量的文件（.env）组成。

本指南展示了应用程序的典型结构，并说明了如何指定使用LangSmith部署应用程序所需的信息。

关键概念

使用LangSmith进行部署时，应提供以下信息：

1. 一个LangGraph配置文件 (langgraph.json)，用于指定应用程序使用的依赖项、图和环境变量。
2. 实现应用程序逻辑的图。
3. 一个指定运行应用程序所需的依赖项的文件。
4. 应用程序运行所需的环境变量。

文件结构

以下是应用程序目录结构的示例：

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 your 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 应用程序所需的依赖项、图、环境变量和其他设置。

查看LangGraph配置文件参考以获取JSON文件中所有支持键的详细信息。

LangGraph CLI（[/langsmith/cli]）默认使用当前目录下的配置文件 langgraph.json。

示例

• 依赖项将从本地目录中的依赖文件（例如，package.json）加载。
• 将从文件 ./your_package/your_file.js 加载单个图，并使用函数 agent。
• 环境变量 OPENAI_API_KEY 在行内设置。

{
  "dependencies": ["."],
  "graphs": {
    "my_agent": "./your_package/your_file.js:agent"
  },
  "env": {
    "OPENAI_API_KEY": "secret-key"
  }
}

依赖项

一个 LangGraph 应用可能依赖于其他 TypeScript/JavaScript 库。

通常，您需要指定以下信息以确保依赖项正确设置：

1. 指定依赖项的目录中的文件（例如，package.json）。

2. LangGraph配置文件中的dependencies键指定了运行LangGraph应用程序所需的依赖项。

3. 可以使用LangGraph配置文件中的dockerfile_lines键指定任何额外的二进制文件或系统库。

图

使用 graphs 键在 LangGraph 配置文件 中指定将在部署的 LangGraph 应用程序中可用的图。

您可以在配置文件中指定一个或多个图。每个图通过一个名称（应该是唯一的）和一个路径来标识，该路径可以是以下两种情况之一：（1）编译后的图；（2）定义生成图的函数。

环境变量

如果您在本地使用已部署的 LangGraph 应用程序，您可以在 LangGraph 配置文件 的 env 键中配置环境变量。

对于生产部署，您通常需要在部署环境中配置环境变量。

---

在GitHub上编辑此页面的源代码。

通过MCP将这些文档编程连接到Claude、VSCode等，以获取实时答案。