跳到主要内容
重要提示 混合选项需要 企业版 计划。
混合 模型将 LangSmith 基础设施分为 LangChain 的云和您的云
  • 控制平面（LangSmith 用户界面、API 和编排）在 LangChain 的云中运行，由 LangChain 管理。
  • 数据平面（您的和代理工作负载）在您的云中运行，由您管理。
这结合了托管界面的便利性和在您自己的环境中运行工作负载的灵活性。
了解更多关于 控制平面、数据平面 和 LangGraph 服务器 架构概念。
组件职责运行位置谁管理
  • 用于创建部署和修订的用户界面
  • 用于管理部署的 API
  • 可观察性数据存储
LangChain 云端LangChain
  • 监听器与控制平面同步
  • LangGraph 服务器（您的代理）
  • 后端服务（Postgres、Redis 等）
您的云端您
在混合模型中运行 LangSmith 时，您需要使用 LangSmith API 密钥 进行身份验证。

​
工作流程

  1. 使用 langgraph-cli 或 Studio 在本地测试您的图。
  2. 使用 langgraph build 命令构建 Docker 镜像。
  3. 从 控制平面 UI 部署您的 LangGraph 服务器。
支持的计算平台：Kubernetes。
有关设置，请参阅 混合设置指南。

​
架构

Hybrid deployment: LangChain-hosted control plane (LangSmith UI/APIs) manages deployments. Your cloud runs a listener, LangGraph Server instances, and backing stores (Postgres/Redis) on Kubernetes.

​
计算平台

  • Kubernetes：混合模式支持在任何 Kubernetes 集群上运行数据平面。
有关 Kubernetes 中的设置，请参阅 混合设置指南

​
出站到 LangSmith 和控制平面

在混合部署模型中，您的自托管数据平面将向控制平面发送网络请求，以轮询需要在数据平面中实施的更改。数据平面部署的跟踪也会发送到与控制平面集成的 LangSmith 实例。到控制平面的流量是加密的，通过 HTTPS。数据平面使用 LangSmith API 密钥向控制平面进行身份验证。 为了启用此出站，您可能需要更新内部防火墙规则或云资源（例如安全组）以允许某些 IP 地址。
目前不支持 AWS/Azure PrivateLink 或 GCP Private Service Connect。此流量将通过互联网传输。

​
监听器

在混合选项中，可以运行一个或多个 “监听器”应用程序，具体取决于您的 LangSmith 工作区和 Kubernetes 集群的组织方式。

​
Kubernetes 集群组织

  • 一个 Kubernetes 集群中可以运行一个或多个监听器。
  • 一个监听器可以部署到该集群中的一个或多个命名空间。
  • 集群所有者负责规划监听器布局和 LangGraph 服务器部署。

​
LangSmith 工作区组织

  • 一个工作区可以与一个或多个监听器关联。
  • 一个工作区只能部署到其所有监听器都部署到的 Kubernetes 集群。

​
用例

以下是一些常见的监听器配置（非严格要求）

​
每个 LangSmith 工作区 → 独立的 Kubernetes 集群

  • 集群 alpha 运行工作区 A
  • 集群 beta 运行工作区 B

​
独立的集群，共享“开发”集群

  • 集群 alpha 运行工作区 A
  • 集群 beta 运行工作区 B
  • 集群 dev 运行工作区 A 和 B
  • 两个工作区都有两个监听器；集群 dev 有两个监听器部署

​
一个集群，每个工作区一个命名空间

  • 集群 alpha，命名空间 1 运行工作区 A
  • 集群 alpha，命名空间 2 运行工作区 B

​
一个集群，一个命名空间用于多个工作区

  • 集群 alpha 运行工作区 A
  • 集群 alpha 运行工作区 B
在 GitHub 上编辑此页面源文件。
以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.