LangSmith 控制平面

控制平面是 LangSmith 中负责管理部署的部分。它包括控制平面界面（用户可在其中创建和更新 Agent Servers），以及控制平面 API（为界面提供支持并提供编程访问能力）。

当你通过控制平面进行更新时，更新会保存在控制平面的状态中。数据平面的“listener”会通过调用控制平面 API 来轮询这些更新。控制平面永远不会直接连接数据平面。

控制平面界面

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

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

控制平面界面内嵌在 LangSmith 中。

控制平面 API

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

集成

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

部署

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

版本

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

Listeners

listener 是"listener" 应用的一个实例。listener 包含有关该应用的元数据（例如版本），以及有关其可部署到的计算基础设施的元数据（例如 Kubernetes 命名空间）。

控制平面功能

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

异步部署

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

• 创建新部署时，会为该部署创建新数据库。数据库创建是一次性步骤。这一步骤导致该部署初始版本的部署时间更长。
• 为部署创建后续版本时，不再有数据库创建步骤。与初始版本相比，后续版本的部署时间要快得多。
• 每个版本的部署过程都包含一个构建步骤，该步骤可能耗时数分钟。

控制平面与数据平面的 "listener" 应用协同工作，以实现异步部署。

监控

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

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

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

LangSmith 集成

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

删除部署时，追踪数据和追踪项目不会被删除。

---