这 _控制平面_ 是 LangSmith 中管理部署的部分。它包括控制平面 UI，用户在此创建和更新 Agent 服务器，以及支持 UI 并提供编程访问的控制平面 API。

当您通过控制平面进行更新时，更新会存储在控制平面状态中。 数据平面 “监听器”通过调用控制平面 API 来轮询这些更新。控制平面从不直接连接到数据平面。

控制平面 UI

通过控制平面 UI，您可以：

• * 查看待处理部署的列表。
• * 查看单个部署的详细信息。
• * 创建新部署。
• * 更新部署。
• * 更新部署的环境变量。
• * 查看部署的构建和服务器日志。
• * 查看部署指标（如 CPU 和内存使用情况）。
• * 删除部署。

控制平面 UI 嵌入在 LangSmith.

控制平面 API

本节介绍控制平面 API 的数据模型。该 API 用于创建、更新和删除部署。请参阅 控制平面 API 参考 了解更多详情。

集成

集成是 git 仓库提供商（例如 GitHub）的抽象。它包含连接和部署所需的所有元数据 git repository.

部署

部署是 Agent Server 的一个实例。一个部署可以有多个版本。

版本

版本是部署的迭代。创建新部署时，会自动创建初始版本。要部署代码更改或更新部署的密钥，必须创建新版本。

监听器

监听器是 "监听器"应用程序的实例。监听器包含有关应用程序的元数据（例如版本）以及有关其可部署到的计算基础设施的元数据（例如 Kubernetes 命名空间）。

控制平面功能

本节介绍控制平面的各种功能。有关平台特定行为（如云部署类型或自托管资源定制），请参阅 云平台功能 or 部署到自托管.

异步部署

部署和版本的基础设施是异步配置和部署的。它们不会在提交后立即部署。目前，部署可能需要长达几分钟时间。

• * 创建新部署时，会为该部署创建一个新数据库。数据库创建是一次性步骤。此步骤会导致部署初始版本的部署时间较长。
• * 当为部署创建后续修订版本时，不会执行数据库创建步骤。后续修订版本的部署时间比初始修订版本的部署时间快得多。
• * 每个修订版本的部署流程都包含一个构建步骤，可能需要几分钟。

控制平面和 数据平面 "listener" 应用程序协调以实现异步部署。

监控

部署就绪后，控制平面会监控部署并记录各种指标，例如：

• * 部署的 CPU 和内存使用情况。
• * 容器重启次数。
• * 副本数量（这会随着 自动扩缩容).
• * PostgreSQL CPU、内存使用量和磁盘使用量。
• * Agent Server 队列 pending/active run count.
• * Agent Server API 成功响应计数、错误响应计数和延迟。

这些指标以图表形式显示在控制平面 UI 中。

LangSmith 集成

A LangSmith 追踪项目会自动为每个部署创建。追踪项目与部署同名。创建部署时， LANGCHAIN_TRACING 和 LANGSMITH_API_KEY/LANGCHAIN_API_KEY 环境变量无需指定，它们由控制平面自动设置。

删除部署时，追踪记录和追踪项目不会被删除。