自托管依赖的最低版本

自托管 LangSmith 所需的数据库、工具和基础设施的最低支持版本。

本页列出 LangSmith 自托管所使用的数据库、工具和基础设施的最低支持版本。在部署或升级之前，请安装达到或超过最低要求的版本。不支持使用低于最低要求的版本，这可能导致安装或运行时失败。

TIP

如果你使用的是托管服务（例如 Amazon RDS、Google Cloud SQL 或 Azure Database），请选择达到或高于此处所列最低要求的版本。有关连接和认证详情，请参阅链接的“External services”页面。

数据存储

依赖项	最低版本	说明
PostgreSQL	14	用于运营数据的主要关系型存储。LangSmith 和独立的 Agent Server 部署都需要它。用于安装 btree_gin、btree_gist、pgcrypto、citext、ltree 和 pg_trgm 扩展。
Redis	6.2	用于排队和缓存。支持 Standalone 和 Redis Cluster 两种模式。从 Agent Server 0.8.0 开始，由 Redis 支持的 run 队列要求 Redis 6.2 或更高版本：它使用 ZADD ... LT 标志将 run 入队，该标志在 6.2 中引入。
Valkey	8	官方支持作为 Redis 的直接替代品。支持 Standalone 和 Cluster 两种模式。
ClickHouse	LangSmith Helm chart 中指定的版本或更高	存储 trace 和反馈。ClickHouse 24.2 或更高版本要求 LangSmith v0.6 或更高版本。不支持降级。

WARNING

不支持 Redis < 6.2 和 PostgreSQL < 14。 指向旧版 Redis 或 PostgreSQL 实例的 LangSmith 安装可能无法启动或行为异常。在安装或升级 LangSmith 之前，请升级你的数据存储。

计算与编排

依赖项	最低版本	说明
Kubernetes	上游 Kubernetes 发布周期支持的任何版本	LangSmith 定期在 GKE、EKS、AKS、Minikube 和 Kind 上进行测试。
OpenShift	4.14	作为 LangSmith 的 Kubernetes 发行版受支持。
Helm	3	用于安装和升级 LangSmith Helm chart。
Docker	与 Docker Compose v2 兼容的版本	基于 Docker 的独立 Agent Server 部署需要它。

LangSmith chart 与平台

依赖项	最低版本	说明
LangSmith Helm chart	最新稳定版本	我们建议固定使用最新的稳定 chart 版本。有关各版本的升级说明，请参阅自托管变更日志。
出站访问 https://beacon.langchain.com	LangSmith 0.9.0 或更高版本	除非以离线模式运行，否则许可证验证和使用情况报告需要它。

这些版本在何处强制执行

• PostgreSQL 14 或更高版本：请参阅连接到外部 PostgreSQL 数据库。
• Redis 6.2 或更高版本以及 Valkey 8：请参阅连接到外部 Redis 或 Valkey 数据库。
• ClickHouse：使用 LangSmith Helm chart 中指定的版本或更高版本：请参阅连接到外部 ClickHouse 数据库。
• Kubernetes 集群前置条件：请参阅在 Kubernetes 上自托管 LangSmith。

如果不确定当前运行的版本，请联系数据库管理员或参阅云提供商的控制台。如果你需要在升级 LangSmith 之前升级某个依赖项，请参阅供应商的文档。

---