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

# 混合模式

<Info>
  混合选项需要 [Enterprise](https://langchain.com/pricing) 计划。[获取演示](https://www.langchain.com/contact-sales) 以了解更多信息。
</Info>

**混合**模式将 LangSmith 基础设施拆分到 LangChain 的云和您的云之间：

* **控制平面**（LangSmith UI、API 和编排）运行在 LangChain 的云中，由 LangChain 管理。
* **数据平面**（您的 <Tooltip tip="运行您应用程序的服务器。">Agent 服务器</Tooltip> 和代理工作负载）运行在您的云中，由您管理。

这结合了托管界面的便利性和在您自己的环境中运行工作负载的灵活性。

<Note>
  了解更多关于 [控制平面](/langsmith/control-plane)、[数据平面](/langsmith/data-plane) 和 [Agent 服务器](/langsmith/agent-server) 架构概念的信息。
</Note>

| 组件                                                        | 职责                                                                                      | 运行位置         | 管理者       |
| --------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------ | --------- |
| <Tooltip tip="用于管理部署的 LangSmith UI 和 API。">控制平面</Tooltip> | <ul><li>用于创建部署和修订的 UI</li><li>用于管理部署的 API</li><li>可观测性数据存储</li></ul>                    | LangChain 的云 | LangChain |
| <Tooltip tip="您的 Agent 服务器和代理执行的运行时环境。">数据平面</Tooltip>    | <ul><li>用于协调部署的操作员/监听器</li><li>Agent 服务器（代理/图）</li><li>后端服务（Postgres、Redis 等）</li></ul> | 您的云          | 您         |

在混合模式下运行 LangSmith 时，您使用 [LangSmith API 密钥](/langsmith/create-account-api-key) 进行身份验证。

### 工作流程

1. 使用 `langgraph-cli` 或 [Studio](/langsmith/studio) 在本地测试您的图。
2. 使用 `langgraph build` 命令构建 Docker 镜像。
3. 从 [控制平面 UI](/langsmith/control-plane#control-plane-ui) 部署您的 Agent 服务器。

<Note>
  支持的计算平台：[Kubernetes](https://kubernetes.io/)。<br />
  有关设置，请参阅 [混合设置指南](/langsmith/deploy-hybrid)。
</Note>

### 架构

<img className="block dark:hidden" src="https://mintcdn.com/other-405835d4/G7l9ZuXFPY6DQG2A/langsmith/images/hybrid-with-deployment-light.png?fit=max&auto=format&n=G7l9ZuXFPY6DQG2A&q=85&s=0c32f9f2d614850cfcbf5cdf3cacb572" alt="混合部署：LangChain 托管的控制平面（LangSmith UI/API）管理部署。您的云在 Kubernetes 上运行监听器、Agent 服务器实例和后端存储（Postgres/Redis）。" width="1784" height="1782" data-path="langsmith/images/hybrid-with-deployment-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/other-405835d4/G7l9ZuXFPY6DQG2A/langsmith/images/hybrid-with-deployment-dark.png?fit=max&auto=format&n=G7l9ZuXFPY6DQG2A&q=85&s=807d84995c830b085ebf5325309181c4" alt="混合部署：LangChain 托管的控制平面（LangSmith UI/API）管理部署。您的云在 Kubernetes 上运行监听器、Agent 服务器实例和后端存储（Postgres/Redis）。" width="1784" height="1782" data-path="langsmith/images/hybrid-with-deployment-dark.png" />

### 计算平台

* **Kubernetes**：混合模式支持在任何 Kubernetes 集群上运行数据平面。

<Tip>
  有关在 Kubernetes 中的设置，请参阅 [混合设置指南](/langsmith/deploy-hybrid)
</Tip>

### 出站流量到 LangSmith 和控制平面

在混合部署模型中，您自托管的数据平面将向控制平面发送网络请求，以轮询需要在数据平面中实现的更改。来自数据平面部署的跟踪数据也会发送到与控制平面集成的 LangSmith 实例。此到控制平面的流量是加密的，通过 HTTPS 传输。数据平面使用 LangSmith API 密钥向控制平面进行身份验证。

为了启用此出站流量，您可能需要更新内部防火墙规则或云资源（例如安全组）以 [允许特定的 IP 地址](/langsmith/cloud#ingress-into-langchain-saas)。

<Warning>
  目前不支持 AWS/Azure PrivateLink 或 GCP Private Service Connect。此流量将通过互联网传输。
</Warning>

## 监听器

在混合选项中，一个或多个 ["监听器" 应用程序](/langsmith/data-plane#listener-application) 可以运行，具体取决于您的 LangSmith 工作区和 Kubernetes 集群的组织方式。

### Kubernetes 集群组织

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

### LangSmith 工作区组织

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

## 用例

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

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

* 集群 `alpha` 运行工作区 `A`
* 集群 `beta` 运行工作区 `B`

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

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

### 独立的集群，共享 "dev" 集群

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

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档](/use-these-docs) 通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/hybrid.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>