要在 LangSmith 上部署，应用程序必须包含一个或多个图、一个配置文件（langgraph.json）、一个指定依赖项的文件以及一个指定环境变量的可选 .env 文件。
本页解释 LangSmith 应用程序的组织方式以及如何提供部署所需的配置详细信息。
关键概念
要使用 LangSmith 部署，请提供以下信息：
- 一个配置文件（
langgraph.json），指定应用程序使用的依赖项、图和环境变量。
- 实现应用程序逻辑的图。
- 一个指定运行应用程序所需的依赖项的文件。
- 应用程序运行所需的环境变量。
Framework agnosticLangSmith Deployment 支持部署 LangGraph 图。但是，图的_节点_的实现可以包含任意 Python 代码。这意味着任何框架都可以在节点内实现并部署在 LangSmith Deployment 上。这使您可以将核心应用程序逻辑保留在 LangGraph 之外，同时仍然使用 LangSmith 进行部署、扩展和可观测性。 文件结构
以下是 Python 和 JavaScript 应用程序的目录结构示例：
my-app/
├── my_agent # 所有项目代码都在这里
│ ├── utils # 图的实用程序
│ │ ├── __init__.py
│ │ ├── tools.py # 图的工具
│ │ ├── nodes.py # 图的节点函数
│ │ └── state.py # 图的状态定义
│ ├── __init__.py
│ └── agent.py # 构建图的代码
├── .env # 环境变量
├── requirements.txt # 包依赖项
└── langgraph.json # LangGraph 的配置文件
my-app/
├── my_agent # 所有项目代码都在这里
│ ├── utils # 图的实用程序
│ │ ├── __init__.py
│ │ ├── tools.py # 图的工具
│ │ ├── nodes.py # 图的节点函数
│ │ └── state.py # 图的状态定义
│ ├── __init__.py
│ └── agent.py # 构建图的代码
├── .env # 环境变量
├── langgraph.json # LangGraph 的配置文件
└── pyproject.toml # 项目的依赖项
my-app/
├── src # 所有项目代码都在这里
│ ├── utils # 图的可选实用程序
│ │ ├── tools.ts # 图的工具
│ │ ├── nodes.ts # 图的节点函数
│ │ └── state.ts # 图的状态定义
│ └── agent.ts # 构建图的代码
├── package.json # 包依赖项
├── .env # 环境变量
└── langgraph.json # LangGraph 的配置文件
应用程序的目录结构可能因编程语言和使用的包管理器而异。
配置文件
langgraph.json 文件是一个 JSON 文件，用于指定部署应用程序所需的依赖项、图、环境变量和其他设置。
有关 JSON 文件中所有支持的键的详细信息，请参阅 LangGraph 配置文件参考。
- 依赖项包括自定义本地包和
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"
}
- 依赖项将从本地目录中的依赖文件（例如
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"
}
}
依赖项
应用程序可能依赖于其他 Python 包或 JavaScript 库（取决于编写应用程序的编程语言）。
通常需要指定以下信息以正确设置依赖项：
- 目录中指定依赖项的文件（例如
requirements.txt、pyproject.toml 或 package.json）。
- 配置文件中的
dependencies 键，指定运行应用程序所需的依赖项。
- 可以使用 LangGraph 配置文件中的
dockerfile_lines 键指定任何其他二进制文件或系统库。
使用配置文件中的 graphs 键指定部署的应用程序中将提供哪些图。
你可以在配置文件中指定一个或多个图。每个图由唯一名称和指向 (1) 已编译图或 (2) 定义图的函数的路径标识。
环境变量
如果你正在本地使用部署的 LangGraph 应用程序，可以在配置文件的 env 键中配置环境变量。
对于生产部署，通常需要在部署环境中配置环境变量。
