LangSmith 根据您的规模、安全性和基础设施需求支持不同的自托管配置。 您可以将 LangSmith 用于可观察性和评估，而无需代理部署。或者，您可以设置完整的自托管平台，用于可观察性、评估和代理部署。另外，您也可以直接部署代理，而无需控制平面。 本页概述了每种自托管模型：
LangSmith 可观察性与评估
托管一个 LangSmith 实例，包括 UI 和 API 中的可观察性、跟踪和评估。最适合需要自托管监控和评估但无需部署代理的团队。
LangSmith 可观察性、评估和部署
通过控制平面将图部署到 LangGraph Server。控制平面和数据平面提供完整的 LangSmith 平台，用于运行和监控代理。这包括可观察性、评估和部署。
独立服务器
直接托管 LangGraph Server，无需控制平面 UI。这是一种轻量级选项，用于将一个或几个代理作为独立服务运行，并完全控制扩展和集成。
| 模型 | 包括 | 最适合 | 方法 |
|---|---|---|---|
| 可观察性与评估 |
|
|
|
| 可观察性、评估与部署 |
|
|
|
| 独立服务器 |
|
|
|
自托管 LangSmith 可观察性与评估
托管一个 LangSmith 实例，包括 UI 和 API 中的可观察性、跟踪和评估，但不具备通过控制平面部署代理的能力。 这包括： 服务：- LangSmith 前端 UI
- LangSmith 后端 API
- LangSmith 平台后端
- LangSmith 游乐场
- LangSmith 队列
- LangSmith ACE（任意代码执行）后端
- ClickHouse（跟踪和反馈数据）
- PostgreSQL（操作数据）
- Redis（队列和缓存）
- Blob 存储（可选，但建议用于生产环境）
服务
存储服务
LangSmith 默认将捆绑所有存储服务。您可以将其配置为使用所有存储服务的外部版本。在生产环境中，我们强烈建议使用外部存储服务。
| 服务 | 描述 |
|---|---|
| ClickHouse | ClickHouse 是一个用于在线分析处理（OLAP）的高性能、列式 SQL 数据库管理系统（DBMS）。 LangSmith 使用 ClickHouse 作为跟踪和反馈（高容量数据）的主要数据存储。 |
| PostgreSQL | PostgreSQL 是一个功能强大的开源对象关系数据库系统，它使用并扩展了 SQL 语言，并结合了许多功能，可以安全地存储和扩展最复杂的数据工作负载。 LangSmith 使用 PostgreSQL 作为事务性工作负载和操作数据（除了跟踪和反馈之外的所有数据）的主要数据存储。 |
| Redis | Redis 是一个功能强大的内存键值数据库，可持久化到磁盘。通过将数据保存在内存中，Redis 为缓存等操作提供了高性能。 LangSmith 使用 Redis 来支持队列和缓存操作。 |
| Blob 存储 | LangSmith 支持多种 blob 存储提供商，包括 AWS S3、Azure Blob 存储和 Google Cloud 存储。 LangSmith 使用 blob 存储来存储大文件，例如跟踪工件、反馈附件和其他大数据对象。Blob 存储是可选的，但强烈建议用于生产部署。 |
设置方法
- Docker Compose（仅限开发/测试）
- Kubernetes + Helm（推荐用于生产环境）
设置指南
- 在 Kubernetes 上安装（生产环境）
- 使用 Docker 安装（仅限开发环境）
启用 LangSmith 部署
LangSmith 部署是一个可选的附加组件，可以在您的 LangSmith 实例上启用。它非常适合希望拥有一个集中式、UI 驱动的平台来部署和管理多个代理和图的企业团队，所有基础设施、数据和编排都完全由他们控制。 这包括 LangSmith 的所有功能，此外还有：| 组件 | 职责 | 运行位置 | 谁管理 |
|---|---|---|---|
| 您的云端 | 您 | |
| 您的云端 | 您 |
工作流程
如果您想自托管 LangSmith 以实现可观察性、评估和代理部署，请按照以下步骤操作1
安装自托管 LangSmith
您必须已经在您的云中安装了一个自托管 LangSmith 实例，并带有一个 Kubernetes 集群（控制平面和数据平面必需）。
2
在本地测试您的图
使用
langgraph-cli 或 Studio 在本地测试您的图。3
启用 LangSmith 部署
按照设置指南在您的 LangSmith 实例上启用 LangSmith 部署。
独立服务器
独立服务器选项是运行 LangSmith 最轻量级和灵活的方式。与其他模型不同，您只管理一个简化的，由 LangGraph 服务器及其所需的后端服务（PostgreSQL、Redis 等）组成。 这包括：| 组件 | 职责 | 运行位置 | 谁管理 |
|---|---|---|---|
| 控制平面 | 不适用 | 不适用 | 不适用 |
| 数据平面 |
| 您的云端 | 您 |
请勿在无服务器环境中运行独立服务器。缩减到零可能会导致任务丢失，并且扩展将无法可靠工作。
工作流程
- 使用
langgraph-cli或 Studio 在本地定义和测试您的图 - 将您的代理打包为 Docker 镜像
- 将 LangGraph Server 部署到您选择的计算平台（Kubernetes、Docker、VM）
- 可选地，配置 LangSmith API 密钥和端点，以便服务器将跟踪和评估报告回 LangSmith（自托管或 SaaS）
支持的计算平台
- Kubernetes：使用 LangSmith Helm 图表在 Kubernetes 集群中运行 LangGraph Server。这是生产级部署的推荐选项。
- Docker：在任何支持 Docker 的计算平台（本地开发机器、VM、ECS 等）中运行。这最适合开发或小规模工作负载。
设置指南
要设置LangGraph Server，请参阅应用程序部署部分的操作指南。
以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。