在合并前为每个 PR 创建独立的 Agent 测试环境

LangSmith 新推出的 Preview Builds 是其 Deployment 功能模块中的一项重要补充。当一个 Pull Request 触发 Preview Build 时，LangSmith 会在与父部署关联的隔离环境中部署该分支的代码，且不会影响父部署的运行状态。这意味着审查人员可以直接测试完整的 Agent 行为，包括尝试不同提示词、触发工具调用、检查追踪记录，以及验证 Agent 在其配置的依赖和服务下的实际表现，而无需接触任何生产环境。

Preview Builds 与 Pull Request 的生命周期保持同步。每当开发者向分支推送新提交，LangSmith 会自动为该预览部署创建新的修订版本，确保预览环境始终反映最新代码状态。开发者可以根据反馈推送更新，并邀请协作者重新测试，而无需重新创建环境或提前合并未完成的工作。代码讨论仍在 Pull Request 中进行，预览环境则提供变更的实际运行版本，两者分工明确。

该功能特别适合跨职能团队的协作审查场景。产品经理可以直接体验用户交互效果，领域专家可以验证术语或策略行为，QA 工程师可以针对已知的失败路径进行测试。预览部署为所有协作者提供一个与 PR 绑定的共享测试入口，反馈可以在变更仍易于修改时及时提出。工程师同样可以利用同一预览环境深入检查工具调用和响应背后的追踪链路，实现技术与业务层面的并行审查。

在资源管理方面，Preview Builds 提供了多项控制选项。团队可以设置空闲 TTL，即预览在最新修订后保持非活跃状态的最长时间，超时后 LangSmith 将自动删除该预览；也可以限制同一父部署下并发运行的预览数量上限；此外，团队还可以随时手动删除预览，删除父部署时其所有预览部署也会一并清除。多个 PR 的预览部署相互隔离，审查人员可以同时比较不同变更，而不必在分支之间切换共享的暂存环境。

在触发策略上，团队可以选择两种模式：Every PR 模式会为每个针对部署分支开启的 PR 自动创建预览，适合大多数变更都需要行为审查的团队；Label only 模式则仅在 PR 被添加特定 GitHub 标签后才创建预览，适合希望对预览创建进行精细控制的场景。在安全性方面，预览部署会在创建时复制父部署的密钥，官方建议对敏感服务使用专为预览工作负载设置的凭证，尤其是当预览可能由外部或低信任贡献者的 PR 触发时。

Preview Builds 目前以公开测试版形式向通过 GitHub 集成连接的 LangSmith Cloud 部署开放。用户可在部署设置中找到 Preview Builds 选项并启用，配置触发策略、空闲 TTL 和并发限制后保存即可生效。下一个符合条件的 Pull Request 将自动从其源分支创建预览部署。这一功能的推出，标志着 LangSmith 在 Agent 工程化流程上迈出了重要一步，将 Agent 的行为验证正式纳入代码审查环节。

要点

• Preview Builds 为每个 Pull Request 自动创建独立的临时 Agent 部署环境，无需额外配置 CI/CD 流程，降低了团队协作审查的门槛
• 预览环境与 PR 分支保持实时同步，每次新提交都会自动触发新修订版本，确保审查者始终测试最新代码
• 产品、QA、领域专家等非工程角色可直接在预览环境中测试 Agent 行为并提供反馈，实现跨职能并行审查
• 支持空闲 TTL、最大并发数等资源管理控制，并建议对预览环境使用独立的低权限凭证以保障生产安全
• 功能目前处于公开测试阶段，仅适用于通过 GitHub 集成连接的 LangSmith Cloud 部署