LangGraph 应用程序由一个或多个图、一个配置文件（langgraph.json）、一个指定依赖项的文件以及一个可选的 .env 文件（用于指定环境变量）组成。 本指南展示了应用程序的典型结构，并向您展示如何提供所需的配置以使用 LangSmith Deployment 部署应用程序。
LangSmith Deployment 是一个用于部署和扩展 LangGraph Agent 的托管托管平台。它处理基础设施、扩展和运营问题，因此您可以直接从代码库部署有状态的长时间运行的 Agent。在部署文档中了解更多。

​
核心概念

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

​
文件结构

以下是应用程序的目录结构示例： 
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 应用程序所需的依赖项、图、环境变量和其他设置。 请参阅 LangGraph 配置文件参考 了解 JSON 文件中所有支持的键的详细信息。
LangGraph CLI 默认使用当前目录中的配置文件 langgraph.json。

​
示例

  • 依赖项包括一个自定义本地包和 langchain_openai 包。
  • 将从文件 ./your_package/your_file.py 中加载名为 variable 的单个图。
  • 环境变量从 .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 键中配置环境变量。 对于生产部署，您通常需要在部署环境中配置环境变量。
在 GitHub 上编辑此页面 或提交问题。
通过 MCP 将这些文档连接到 Claude、VSCode 等，获得实时答案。