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