LangSmith 控制平面

控制平面 是 LangSmith 中负责管理部署的部分。它包括控制平面 UI，用户可以在其中创建和更新 Agent Server，还包括控制平面 API，用于支持 UI 并提供程序化访问。 当你通过控制平面进行更新时，更新内容会存储在控制平面状态中。数据平面“监听器”通过调用控制平面 API 轮询这些更新。控制平面不会直接连接到数据平面。

​

控制平面 UI

在控制平面 UI 中，你可以：

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

控制平面 UI 嵌入在 LangSmith 中。

​

控制平面 API

本节介绍控制平面 API 的数据模型。该 API 用于创建、更新和删除部署。有关更多详细信息，请参阅控制平面 API 参考。

​

集成

集成是对 git 仓库提供商（例如 GitHub）的抽象。它包含连接到 git 仓库并从中进行部署所需的全部元数据。

​

部署

部署是 Agent Server 的一个实例。单个部署可以包含多个修订版本。

​

修订版本

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

​

监听器

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

​

控制平面功能

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

​

异步部署

部署和修订版本所需的基础设施会异步进行配置和部署。提交后不会立即完成部署。目前，部署最多可能需要几分钟。

• 创建新部署时，系统会为该部署创建一个新数据库。数据库创建是一次性步骤。此步骤会延长部署初始修订版本所需的时间。
• 为部署创建后续修订版本时，无需创建数据库。与初始修订版本相比，后续修订版本的部署速度会明显更快。
• 每个修订版本的部署流程都包含构建步骤，可能需要几分钟。

控制平面与数据平面的“监听器”应用程序相互协调，以实现异步部署。

​

监控

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

• 部署的 CPU 和内存使用情况。
• 容器重启次数。
• 副本数量（该数量会随着自动扩缩容而增加）。
• PostgreSQL 的 CPU、内存和磁盘使用情况。
• Agent Server 队列中待处理和正在运行的任务数量。
• Agent Server API的成功响应数、错误响应数和延迟。

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

​

LangSmith 集成

系统会为每个部署自动创建一个 LangSmith 跟踪项目。跟踪项目的名称与部署名称相同。创建部署时，无需指定 LANGCHAIN_TRACING 和 LANGSMITH_API_KEY/LANGCHAIN_API_KEY 环境变量；控制平面会自动设置这些变量。 删除部署时，跟踪记录和跟踪项目不会被删除。

---