​
概述

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 应用程序所需的依赖项、图、环境变量和其他设置。 有关 JSON 文件中所有支持的键的详细信息，请参阅 LangGraph 配置文件参考。
LangGraph 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 键指定任何其他二进制文件或系统库。

​
图

使用 LangGraph 配置文件中的 graphs 键来指定部署的 LangGraph 应用程序中将提供哪些图。 您可以在配置文件中指定一个或多个图。每个图由名称（应该是唯一的）和路径标识，路径可以是：(1) 编译的图或 (2) 定义创建图的函数。

​
环境变量

如果您在本地使用部署的 LangGraph 应用程序，可以在 LangGraph 配置文件的 env 键中配置环境变量。 对于生产部署，您通常希望在部署环境中配置环境变量。
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.