> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-zh.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# LangSmith 控制平面

**控制平面**是 LangSmith 中负责管理部署的部分。它包括控制平面用户界面（用户在此创建和更新[智能体服务器](/langsmith/agent-server)）以及控制平面 API（该 API 支持用户界面并提供编程访问）。

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

## 控制平面用户界面

通过控制平面用户界面，您可以：

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

控制平面用户界面内嵌于 [LangSmith](https://docs.smith.langchain.com) 中。

## 控制平面 API

本节介绍控制平面 API 的数据模型。该 API 用于创建、更新和删除部署。更多详情请参阅[控制平面 API 参考](/langsmith/api-ref-control-plane)。

### 集成

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

### 部署

部署是智能体服务器的一个实例。单个部署可以有许多修订版本。

### 修订版本

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

### 监听器

监听器是[“监听器”应用程序](/langsmith/data-plane#listener-application)的一个实例。监听器包含有关应用程序的元数据（例如版本）以及有关其可部署到的计算基础设施的元数据（例如 Kubernetes 命名空间）。

监听器数据模型仅适用于[混合部署](/langsmith/hybrid)和[自托管部署](/langsmith/self-hosted)。

## 控制平面功能

本节介绍控制平面的各项功能。

### 部署类型

为简化起见，控制平面提供两种具有不同资源分配的部署类型：`开发` 和 `生产`。

| **部署类型** | **CPU/内存**      | **扩缩容**   | **数据库**                |
| -------- | --------------- | --------- | ---------------------- |
| 开发       | 1 CPU, 1 GB RAM | 最多 1 个副本  | 10 GB 磁盘，无备份           |
| 生产       | 2 CPU, 2 GB RAM | 最多 10 个副本 | 自动扩缩磁盘，自动备份，高可用（多区域配置） |

CPU 和内存资源按副本分配。

<Warning>
  **不可变部署类型**
  部署创建后，其部署类型无法更改。
</Warning>

<Info>
  **自托管部署**
  [混合部署](/langsmith/hybrid)和[自托管部署](/langsmith/self-hosted)的资源可以完全自定义。部署类型仅适用于[云部署](/langsmith/cloud)。
</Info>

#### 生产

`生产` 类型部署适用于“生产”工作负载。例如，对于关键路径中面向客户的应用程序，请选择 `生产`。

`生产` 类型部署的资源可以根据具体用例和容量限制，按个案手动增加。如需请求增加资源，请通过 [support.langchain.com](https://support.langchain.com) 联系支持团队。

#### 开发

`开发` 类型部署适用于开发和测试。例如，对于内部测试环境，请选择 `开发`。`开发` 类型部署不适用于“生产”工作负载。

<Danger>
  **可抢占式计算基础设施**
  `开发` 类型部署（API 服务器、队列服务器和数据库）在可抢占式计算基础设施上配置。这意味着计算基础设施**可能在任何时候被终止，且不另行通知**。这可能导致间歇性的...

  * Redis 连接超时/错误
  * Postgres 连接超时/错误
  * 失败或重试的后台运行

  此行为是预期的。可抢占式计算基础设施**显著降低了配置 `开发` 类型部署的成本**。智能体服务器的设计具有容错性。其实现会自动尝试从 Redis/Postgres 连接错误中恢复，并重试失败的后台运行。

  `生产` 类型部署配置在持久性计算基础设施上，而非可抢占式计算基础设施。
</Danger>

`开发` 类型部署的数据库磁盘大小可以根据具体用例和容量限制，按个案手动增加。对于大多数用例，应配置 [TTL](/langsmith/configure-ttl) 来管理磁盘使用量。如需请求增加资源，请通过 [support.langchain.com](https://support.langchain.com) 联系支持团队。

### 数据库配置

控制平面和[数据平面](/langsmith/data-plane)的“监听器”应用程序协同工作，自动为每个部署创建一个 Postgres 数据库。该数据库作为部署的[持久化层](/oss/python/langgraph/persistence#memory-store)。

在实现 LangGraph 应用程序时，开发人员无需配置[检查点器](/oss/python/langgraph/persistence#checkpointer-libraries)。相反，系统会自动为图配置一个检查点器。为图配置的任何检查点器都将被自动配置的检查点器替换。

无法直接访问数据库。所有对数据库的访问都通过[智能体服务器](/langsmith/agent-server)进行。

数据库在部署本身被删除之前永远不会被删除。

<Info>
  可以为[混合部署](/langsmith/hybrid)和[自托管部署](/langsmith/self-hosted)配置自定义的 Postgres 实例。
</Info>

### 异步部署

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

* 创建新部署时，会为该部署创建一个新数据库。数据库创建是一次性步骤。此步骤导致部署的初始修订版本的部署时间较长。
* 为部署创建后续修订版本时，没有数据库创建步骤。后续修订版本的部署时间比初始修订版本的部署时间显著更快。
* 每个修订版本的部署过程包含一个构建步骤，该步骤可能需要几分钟。

控制平面和[数据平面](/langsmith/data-plane)的“监听器”应用程序协同工作，实现异步部署。

### 监控

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

* 部署的 CPU 和内存使用情况。
* 容器重启次数。
* 副本数量（此数量会随着[自动扩缩容](/langsmith/data-plane#autoscaling)而增加）。
* [PostgreSQL](/langsmith/data-plane#postgresql) 的 CPU、内存使用量和磁盘使用量。
* [智能体服务器队列](/langsmith/agent-server#persistence-and-task-queue)的待处理/活动运行计数。
* [智能体服务器 API](/langsmith/agent-server) 的成功响应计数、错误响应计数和延迟。

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

### LangSmith 集成

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

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

***

<div className="source-links">
  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/i18n\zh-CN\langsmith\control-plane.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>

  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
  </Callout>
</div>