概览
一个 LangGraph 应用程序由一个或多个图、一个配置文件 (langgraph.json)、一个指定依赖项的文件以及一个可选的指定环境变量的 .env 文件组成。 本指南展示了应用程序的典型结构,并展示了如何指定使用 LangSmith 部署应用程序所需的信息。核心概念
要使用 LangSmith 进行部署,应提供以下信息- 一个 LangGraph 配置文件 (
langgraph.json),用于指定应用程序使用的依赖项、图和环境变量。 - 实现应用程序逻辑的 图。
- 一个指定运行应用程序所需的 依赖项 的文件。
- 应用程序运行所需的 环境变量。
文件结构
以下是应用程序的目录结构示例LangGraph 应用程序的目录结构可能因编程语言和使用的包管理器而异。
配置文件
langgraph.json 文件是一个 JSON 文件,它指定了部署 LangGraph 应用程序所需的依赖项、图、环境变量和其他设置。 有关 JSON 文件中所有支持的键的详细信息,请参阅LangGraph 配置文件参考。LangGraph CLI 默认使用当前目录中的
langgraph.json 配置文件。示例
- 依赖项将从本地目录中的依赖项文件(例如
package.json)加载。 - 一个图将从文件
./your_package/your_file.js中加载,其中包含函数agent。 - 环境变量
OPENAI_API_KEY是内联设置的。
依赖项
LangGraph 应用程序可能依赖于其他 TypeScript/JavaScript 库。 您通常需要指定以下信息才能正确设置依赖项:-
目录中指定依赖项的文件(例如
package.json)。 -
LangGraph 配置文件中的
dependencies键,用于指定运行 LangGraph 应用程序所需的依赖项。 -
任何额外的二进制文件或系统库都可以使用 LangGraph 配置文件 中的
dockerfile_lines键指定。
图
使用 LangGraph 配置文件中的graphs 键来指定已部署的 LangGraph 应用程序中将可用的图。 您可以在配置文件中指定一个或多个图。每个图都由一个名称(必须是唯一的)和一个路径来标识,该路径可以是:(1) 已编译的图,或 (2) 定义图的函数。环境变量
如果您在本地使用已部署的 LangGraph 应用程序,可以在 LangGraph 配置文件的env 键中配置环境变量。 对于生产部署,您通常希望在部署环境中配置环境变量。以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。