您可以在自己控制的云环境中通过 Kubernetes(推荐)或 Docker 运行 LangSmith。LangSmith 应用程序由多个组件组成,包括 LangSmith 服务器和有状态服务。
- LangSmith 前端
- LangSmith 后端
- LangSmith 平台后端
- LangSmith Playground
- LangSmith 队列
- LangSmith ACE (任意代码执行) 后端
- ClickHouse
- PostgreSQL
- Redis
- Blob 存储(可选,但推荐)

存储服务
LangSmith 自托管版默认将捆绑所有存储服务。您可以配置 LangSmith 使用所有存储服务的外部版本。在生产环境中,我们强烈建议使用外部存储服务。
ClickHouse
ClickHouse 是一款高性能、面向列的 SQL 数据库管理系统(DBMS),专为在线分析处理(OLAP)设计。 LangSmith 使用 ClickHouse 作为跟踪和反馈(高容量数据)的主要数据存储。PostgreSQL
PostgreSQL 是一款功能强大的开源对象关系数据库系统,它使用并扩展了 SQL 语言,并结合了许多特性,可以安全地存储和扩展最复杂的数据工作负载。 LangSmith 使用 PostgreSQL 作为事务性工作负载和操作数据(除了跟踪和反馈之外的所有内容)的主要数据存储。Redis
Redis 是一款强大的内存键值数据库,可持久化到磁盘。通过将数据保存在内存中,Redis 为缓存等操作提供了高性能。 LangSmith 使用 Redis 来支持队列和缓存操作。Blob 存储
LangSmith 支持多种 blob 存储提供商,包括AWS S3、Azure Blob 存储和Google Cloud 存储。 LangSmith 使用 blob 存储来存储大文件,例如跟踪工件、反馈附件和其他大型数据对象。Blob 存储是可选的,但强烈建议用于生产部署。服务
LangSmith 前端
前端使用 Nginx 来提供 LangSmith UI 并将 API 请求路由到其他服务器。这作为应用程序的入口点,并且是唯一必须暴露给用户的组件。LangSmith 后端
后端是 CRUD API 请求的主要入口点,并处理应用程序的大部分业务逻辑。这包括处理来自前端和 SDK 的请求,准备跟踪以供摄取,以及支持中心 API。LangSmith 队列
队列处理传入的跟踪和反馈,以确保它们异步摄取并持久化到跟踪和反馈数据存储中,处理数据完整性检查并确保成功插入数据存储,处理数据库错误或暂时无法连接数据库等情况下的重试。LangSmith 平台后端
平台后端是另一个关键服务,主要处理身份验证、运行摄取和其他高容量任务。LangSmith Playground
Playground 是一项服务,负责将请求转发到各种 LLM API,以支持 LangSmith Playground 功能。这也可以用于连接到您自己的自定义模型服务器。LangSmith ACE (任意代码执行) 后端
ACE 后端是一项服务,负责在安全环境中执行任意代码。这用于支持在 LangSmith 中运行自定义代码。以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。
