LangGraph 控制平面¶
术语“控制平面”被广泛用于指代用户创建和更新 LangGraph Server（部署）的控制平面 UI，以及支持 UI 体验的控制平面 API。
当用户通过控制平面 UI 进行更新时，更新会存储在控制平面状态中。LangGraph 数据平面的“监听器”应用程序通过调用控制平面 API 来轮询这些更新。
控制平面 UI¶
通过控制平面 UI，您可以：
- 查看待处理的部署列表。
- 查看单个部署的详细信息。
- 创建新的部署。
- 更新部署。
- 更新部署的环境变量。
- 查看部署的构建和服务器日志。
- 删除部署。
控制平面 UI 嵌入在LangSmith中。
控制平面 API¶
本节描述 LangGraph 控制平面 API 的数据模型。控制平面 API 用于创建、更新和删除部署。但是，它们不可公开访问。
部署¶
部署是 LangGraph Server 的一个实例。单个部署可以有多个修订版本。
修订版本¶
修订版本是部署的一次迭代。创建新的部署时，会自动创建一个初始修订版本。要部署代码更改或更新部署的环境变量，必须创建一个新的修订版本。
环境变量¶
为部署设置环境变量。所有环境变量都作为秘密存储（即保存在秘密存储中）。
控制平面特性¶
本节描述控制平面的各种特性。
部署类型¶
为简单起见，控制平面提供两种具有不同资源分配的部署类型：Development（开发）和 Production（生产）。
| 部署类型 | CPU | 内存 | 扩展性 |
|---|---|---|---|
| 开发 | 1 CPU | 1 GB | 最多 1 个容器 |
| 生产 | 2 CPU | 2 GB | 最多 10 个容器 |
CPU 和内存资源是按容器计算的。
对于 Production 类型部署，可以根据用例和容量限制手动增加资源。请联系 support@langchain.dev 请求增加资源。
数据库配置¶
控制平面和LangGraph 数据平面的“监听器”应用程序协同工作，自动为每个部署创建一个 Postgres 数据库。该数据库充当部署的持久化层。
实现 LangGraph 应用程序时，开发者无需配置检查点。相反，会自动为图配置检查点。任何为图配置的检查点都将被自动配置的检查点替换。
无法直接访问数据库。所有对数据库的访问都通过LangGraph Server进行。
在删除部署本身之前，数据库永远不会被删除。有关更多详细信息，请参阅自动删除。
异步部署¶
部署和修订版本的基础设施是异步配置和部署的。提交后不会立即部署。目前，部署可能需要长达几分钟。
- 创建新的部署时，会为该部署创建一个新的数据库。数据库创建是一次性步骤。此步骤会导致部署的初始修订版本部署时间更长。
- 为部署创建后续修订版本时，没有数据库创建步骤。后续修订版本的部署时间比初始修订版本的部署时间快得多。
- 每个修订版本的部署过程都包含构建步骤，可能需要几分钟。
控制平面和LangGraph 数据平面的“监听器”应用程序协同工作以实现异步部署。
自动删除¶
仅适用于Cloud SaaS
部署的自动删除仅适用于Cloud SaaS。
控制平面在连续 28 天未使用（处于未使用状态）后自动删除部署。如果部署连续 28 天没有向 LangSmith 发出跟踪，则部署处于未使用状态。在任何一天，如果部署向 LangSmith 发出跟踪，连续未使用的天数计数器将重置。
- 连续 7 天未使用后会发送电子邮件通知。
- 连续 28 天未使用后，部署将被删除。
数据无法恢复
部署删除后，部署的数据（例如 Postgres）无法恢复。
LangSmith 集成¶
自动为每个部署创建一个LangSmith跟踪项目。跟踪项目与部署同名。创建部署时，无需指定 LANGCHAIN_TRACING 和 LANGSMITH_API_KEY/LANGCHAIN_API_KEY 环境变量；它们由控制平面自动设置。
删除部署时，跟踪记录和跟踪项目不会被删除。