Vercel AI SDK 更新：@ai-sdk/workflow 2.0.29 修复工具结果保留问题

版本更新概览

Vercel 旗下的 AI SDK 发布了 @ai-sdk/workflow 2.0.29 补丁版本。这是一个以修复为主的小版本更新，核心改动集中在工作流（workflow）执行过程中工具调用结果的处理逻辑上。作为拥有 26.7k Star、5.1k Fork 的活跃开源项目，AI SDK 是构建 AI 应用的重要基础设施，其工作流模块的稳定性直接影响到大量下游应用。

本次更新由 GitHub Actions 自动发布，并经过 GitHub 官方验证签名（GPG key ID: B5690EEEBB952194），确保了发布来源的可信性。

核心修复：跨状态保留工具执行结果

本次版本最关键的改动是一条 Patch Change（提交哈希 72d9e05）：

fix(workflow): preserve provider-executed tool results across terminal, deferred, and paused responses

翻译过来，这个修复确保了「由 provider 执行的工具调用结果」能够在三种不同的响应状态下被正确保留：

• terminal（终止响应）：工作流走到最终结束状态时
• deferred（延迟响应）：结果被推迟返回的场景
• paused（暂停响应）：工作流被暂停、后续可能恢复的场景

在此之前，当工作流进入这些非标准的流转状态时，provider 执行的工具结果有可能丢失，导致后续步骤拿不到正确的上下文数据。对于依赖多步工具调用、需要人机交互中断（human-in-the-loop）或异步等待的复杂 Agent 工作流来说，这类丢失会直接破坏执行链路的完整性。

为什么这个修复值得关注

随着 AI 应用从单轮对话走向多步骤、可中断的 Agent 架构，工作流的「状态持久化」变得越来越重要。一个典型场景是：Agent 调用外部工具后暂停，等待用户确认或外部事件，随后恢复执行。如果工具结果在暂停期间丢失，恢复后的工作流就会失去关键上下文。这次修复正是补齐了这一环节，让暂停/恢复、延迟返回等高级模式更加可靠。

Provider-executed tool（由 provider 执行的工具）是指工具的实际调用由模型服务商（如 OpenAI、Anthropic）在服务端完成，而非在客户端代码中执行。这与客户端工具调用（client-side tool call）形成对比：后者由开发者在本地代码中实现逻辑并返回结果，而 provider-executed tool 则将执行权交给上游 API，通常用于内置搜索、代码解释器等服务商托管能力。

Human-in-the-loop（人机交互中断） 是 Agent 架构中的一种重要模式，指在自动化流程中设置检查点，让人类在关键决策节点介入审核或确认。例如，Agent 准备发送邮件或执行付款前，工作流暂停并等待用户批准，批准后再从断点恢复执行。这要求系统能够将当前所有上下文（包括已完成的工具调用结果）序列化并持久化，否则恢复时就会出现上下文断裂——也正是此次修复所针对的核心问题。

依赖项同步升级

除了自身的修复，2.0.29 还同步更新了一系列内部依赖，反映出 AI SDK 生态各模块之间的紧密联动：

• @ai-sdk/provider@4.0.14
• ai@7.0.98
• @ai-sdk/provider-utils@5.0.40

这些依赖更新涉及多个上游提交（如 5ec21a6、db59d78、7469a3b、f87bf07 等）。虽然发布说明未逐一展开每个提交的细节，但从版本号可以看出，核心 ai 包已经推进到 7.0.98，整个 SDK 处于高频迭代状态。这也提醒使用者：在生产环境中固定依赖版本、并在升级前充分测试，仍然是必要的工程实践。

AI SDK 采用 Monorepo 架构，@ai-sdk/workflow、@ai-sdk/provider、@ai-sdk/provider-utils 和核心 ai 包作为独立 npm 包分版本发布，但彼此之间存在严格的版本依赖关系。provider-utils 负责跨 provider 的底层工具函数（如请求序列化、响应解析），provider 定义标准接口规范，ai 是面向开发者的上层 API 封装，workflow 则是在此之上实现状态机和多步骤编排的模块。当底层包有修复或优化时，上层包需要同步锁定新版本依赖才能获得改进，因此一次补丁发布往往会带动整条依赖链同步推进版本号。

对开发者的实际影响

对于正在使用 AI SDK 构建 Agent 或工作流应用的团队，这次更新的建议是明确的：

如果你的应用涉及 provider 执行的工具调用，且使用了暂停/恢复、延迟响应等模式，那么升级到 2.0.29 可以直接受益，避免工具结果丢失带来的隐蔽 Bug。这类问题往往难以复现和定位，及时打上补丁能省去大量排查成本。

对于仅使用基础对话或简单工具调用的应用，这次更新的影响相对有限，但跟随小版本升级通常是低风险的，可以顺带获得依赖项的改进。

小结

@ai-sdk/workflow@2.0.29 是一次典型的「稳定性优先」补丁发布，核心解决了工作流在终止、延迟、暂停三种状态下工具结果的保留问题，并同步更新了核心依赖。它虽不是功能性大版本，但对于依赖复杂 Agent 工作流的开发者而言，是一个值得及时跟进的可靠性改进。