发布策略

自托管 LangSmith 通过两个发布渠道提供：一个是供客户在生产环境中运行的稳定渠道，另一个是跟踪下一个主要版本的预览渠道。

​

发布渠道

​

稳定版

当前正式可用的主要版本。LangSmith 推荐在生产环境中使用此渠道。稳定版接收每周补丁发布，其中仅包含关键错误修复和安全补丁。在主要版本之间，稳定版不会引入新功能、数据迁移或基础设施变更。 在任何给定时间，最新的主要版本（N）是预览渠道，而前一个主要版本（N-1）是稳定版。

​

预览版

下一个主要版本的开发构建。预览版包含新功能和修复，这些内容会在合并到 LangSmith SaaS 后即出现，因此您可以在下一个主要版本变为稳定版之前对其进行评估。预览版构建可能包含数据迁移，但绝不会添加或删除服务，也不会引入破坏性变更。 预览版旨在用于测试和预演环境的评估。LangSmith 不建议在生产环境中运行预览版。

​

发布节奏

​

各渠道发布内容

服务添加、服务移除和破坏性变更仅会出现在新的主要版本中，因此请在规划向新主要版本升级时考虑到这一点。

​

版本编号

自托管 LangSmith 使用以下方案：

• v0.X.0：主要版本（稳定正式发布）
• v0.X.Y：稳定补丁发布（仅包含关键修复）
• v0.X.0-rcN：下一个主要版本的预览构建（候选发布版），其中 N 是一个递增的构建编号

​

版本支持

LangSmith 支持当前稳定的主要版本和前两个稳定的主要版本。当 N 代表当前稳定的主要版本时：

• N 获得主动支持，包括关键错误修复、安全补丁和新的补丁发布。
• N-1 和 N-2 获得关键支持，包括关键错误修复和安全补丁。
• 早于 N-2 的版本已停止支持，不会再收到新的补丁发布、错误修复或安全更新。

​

建议

• 在生产环境中运行稳定版。 预览版仅用于评估，可能包含仍在验证中的未发布功能。
• 在测试或预演环境中使用预览版。 在非生产环境中运行预览版是尽早发现问题并为下一个主要版本升级做准备的最佳方式。
• 为主要升级做好计划。 数据迁移、服务添加或移除以及破坏性变更只会在新的主要版本中出现。在升级前请查阅自托管变更日志，并规划任何必要的数据或基础设施变更。
• 保持使用受支持的版本。 建议在每个新的主要版本发布后尽快升级，以按照推荐的节奏获得架构改进。

​

当前版本

要检查当前稳定版和预览版，请参阅自托管变更日志。

​

另请参阅

• 发布阶段，了解功能如何从 Alpha 阶段发展到正式发布
• API 和 SDK 弃用策略，了解弃用的端点和方法如何被移除

---