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