跳到主要内容

概览

一个 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 键中配置环境变量。 对于生产部署,您通常希望在部署环境中配置环境变量。
以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.