Skip to main content
控制平面是 LangSmith 中负责管理部署的部分。它包括控制平面用户界面(用户在此创建和更新智能体服务器)以及控制平面 API(该 API 支持用户界面并提供编程访问)。 当您通过控制平面进行更新时,更新会存储在控制平面状态中。数据平面的“监听器”通过调用控制平面 API 来轮询这些更新。控制平面从不直接连接到数据平面。

控制平面用户界面

通过控制平面用户界面,您可以:
  • 查看待处理部署的列表。
  • 查看单个部署的详细信息。
  • 创建新部署。
  • 更新部署。
  • 更新部署的环境变量。
  • 查看部署的构建和服务器日志。
  • 查看部署指标,如 CPU 和内存使用情况。
  • 删除部署。
控制平面用户界面内嵌于 LangSmith 中。

控制平面 API

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

集成

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

部署

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

修订版本

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

监听器

监听器是“监听器”应用程序的一个实例。监听器包含有关应用程序的元数据(例如版本)以及有关其可部署到的计算基础设施的元数据(例如 Kubernetes 命名空间)。 监听器数据模型仅适用于混合部署自托管部署

控制平面功能

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

部署类型

为简化起见,控制平面提供两种具有不同资源分配的部署类型:开发生产
部署类型CPU/内存扩缩容数据库
开发1 CPU, 1 GB RAM最多 1 个副本10 GB 磁盘,无备份
生产2 CPU, 2 GB RAM最多 10 个副本自动扩缩磁盘,自动备份,高可用(多区域配置)
CPU 和内存资源按副本分配。
不可变部署类型 部署创建后,其部署类型无法更改。
自托管部署 混合部署自托管部署的资源可以完全自定义。部署类型仅适用于云部署

生产

生产 类型部署适用于“生产”工作负载。例如,对于关键路径中面向客户的应用程序,请选择 生产 生产 类型部署的资源可以根据具体用例和容量限制,按个案手动增加。如需请求增加资源,请通过 support.langchain.com 联系支持团队。

开发

开发 类型部署适用于开发和测试。例如,对于内部测试环境,请选择 开发开发 类型部署不适用于“生产”工作负载。
可抢占式计算基础设施 开发 类型部署(API 服务器、队列服务器和数据库)在可抢占式计算基础设施上配置。这意味着计算基础设施可能在任何时候被终止,且不另行通知。这可能导致间歇性的…
  • Redis 连接超时/错误
  • Postgres 连接超时/错误
  • 失败或重试的后台运行
此行为是预期的。可抢占式计算基础设施显著降低了配置 开发 类型部署的成本。智能体服务器的设计具有容错性。其实现会自动尝试从 Redis/Postgres 连接错误中恢复,并重试失败的后台运行。生产 类型部署配置在持久性计算基础设施上,而非可抢占式计算基础设施。
开发 类型部署的数据库磁盘大小可以根据具体用例和容量限制,按个案手动增加。对于大多数用例,应配置 TTL 来管理磁盘使用量。如需请求增加资源,请通过 support.langchain.com 联系支持团队。

数据库配置

控制平面和数据平面的“监听器”应用程序协同工作,自动为每个部署创建一个 Postgres 数据库。该数据库作为部署的持久化层 在实现 LangGraph 应用程序时,开发人员无需配置检查点器。相反,系统会自动为图配置一个检查点器。为图配置的任何检查点器都将被自动配置的检查点器替换。 无法直接访问数据库。所有对数据库的访问都通过智能体服务器进行。 数据库在部署本身被删除之前永远不会被删除。
可以为混合部署自托管部署配置自定义的 Postgres 实例。

异步部署

部署和修订版本的基础设施是异步配置和部署的。它们不会在提交后立即部署。目前,部署可能需要几分钟时间。
  • 创建新部署时,会为该部署创建一个新数据库。数据库创建是一次性步骤。此步骤导致部署的初始修订版本的部署时间较长。
  • 为部署创建后续修订版本时,没有数据库创建步骤。后续修订版本的部署时间比初始修订版本的部署时间显著更快。
  • 每个修订版本的部署过程包含一个构建步骤,该步骤可能需要几分钟。
控制平面和数据平面的“监听器”应用程序协同工作,实现异步部署。

监控

部署就绪后,控制平面会监控部署并记录各种指标,例如: 这些指标在控制平面用户界面中以图表形式显示。

LangSmith 集成

系统会自动为每个部署创建一个 LangSmith 追踪项目。该追踪项目的名称与部署名称相同。创建部署时,无需指定 LANGCHAIN_TRACINGLANGSMITH_API_KEY/LANGCHAIN_API_KEY 环境变量;它们由控制平面自动设置。 删除部署时,追踪记录和追踪项目不会被删除。