@ai-sdk/workflow 2.0.106 修复工具审批上下文缺陷

@ai-sdk/workflow 2.0.106 修复工具审批机制的三个上下文缺陷,并同步更新底层依赖。
@ai-sdk/workflow 发布 2.0.106 补丁版本,集中修复 WorkflowAgent 的 toolApproval 机制中的三处逻辑缺陷。第一,审批函数不再接收包含工具调用的助手回复,只接收本步骤真正发给模型的消息,避免待处理或被拒绝的兄弟调用污染上下文。第二,审批策略改用 prepareStep 返回的当前步骤 runtimeContext,而非调用开始时的上下文,确保逐步收紧权限的策略真正生效,并与 ToolLoopAgent 对齐。第三,服务端工具的工具元数据、动态标记和标题现在会透传给审批策略,修复因元数据缺失导致的误放行或误拦截。此外,补丁同步更新了 ai@7.0.174 等底层依赖。使用人工审批环节的 Agent 工作流建议尽快升级。

Vercel 的 AI SDK 生态里,@ai-sdk/workflow 是一个专注多步工作流编排的包。它最近发布了 2.0.106 补丁版本,核心改动集中在 WorkflowAgent 的 工具审批(toolApproval)机制 上。这个版本没有新功能,但修的是那种“平时不显眼、出问题却很难排查”的逻辑缺陷。
审批函数此前看到了不该看的历史
最关键的修复是 b3588dc。在此之前,WorkflowAgent 会把包含工具调用的助手回复传给 toolApproval 审批函数,导致审批逻辑看到的上下文里混入了待处理、被拒绝以及无效的兄弟调用,它们被当成了已经完成的历史消息。换句话说,审批函数拿到的信息比它应该拿到的多。
修复后的行为对齐了 generateText 和 streamText 的文档约定:审批函数只接收本步骤真正发给模型的消息,不包含 system 消息,也不包含当前响应。这样一来,审批策略的输入变得干净可控,避免了基于脏上下文做出误判。
逐步收紧权限时,审批要用当前步骤的运行时上下文
第二个修复 f3d7a10 解决的是运行时上下文错位的问题。WorkflowAgent 现在会把 prepareStep 返回的 runtimeContext 传给该步骤的审批策略,而不是沿用调用开始时的上下文。
这个差异在多步工作流里影响很大:如果某个策略设计为逐步收紧权限,用旧上下文就会让后续步骤仍按宽松的初始权限放行,限制形同虚设。修复后的行为与 ToolLoopAgent 保持一致。
prepareStep 是 AI SDK 中 Agent 工作流的一个钩子,允许开发者在每个步骤执行前动态调整该步骤的配置,包括模型参数、工具集以及运行时上下文(runtimeContext)。在 WorkflowAgent 中,prepareStep 的返回值会作用于当前步骤,因此其携带的 runtimeContext 反映了该步骤特有的权限或环境信息。ToolLoopAgent 是 AI SDK 中负责工具调用循环的底层 Agent,它同样在每一步读取 prepareStep 返回的上下文,从而保证策略的逐步演进。本次修复将 WorkflowAgent 的行为与 ToolLoopAgent 对齐,意味着开发者可以依赖 prepareStep 实现诸如“第一步只读、第二步允许写入”之类的渐进式权限模型。
工具元数据、动态标记与标题一并透传
第三个修复 7655f47 补上了元数据的传递路径。WorkflowAgent 现在会把服务端工具定义的工具元数据、动态标记和标题传给 toolApproval 策略,无论是对新发起的工具调用,还是从消息历史回放中重新审批的调用,都走这条通路。
此前的问题是:依赖 toolCall.toolMetadata 保护工具的策略可能直接放行,而不再要求审批的策略又可能仍把调用判定为待审批。两种情况都会让审批策略和实际执行脱节。
工具元数据(toolMetadata)是服务端工具定义中附加的任意结构化信息,常用于标注工具的敏感级别、所需权限或业务分类。动态标记(dynamic flag)表示工具是否在运行时动态生成,而非静态声明;标题则用于人类可读的展示。在 toolApproval 策略中,这些字段是判断是否放行或要求人工审批的重要依据。例如,策略可以依据 toolMetadata 中的 sensitivity: high 强制要求审批。如果这些字段在审批时缺失,策略可能误将敏感工具当作普通工具直接放行,或者对已明确无需审批的工具重复拦截。透传这些信息确保了审批策略与工具定义之间的语义一致性,无论调用是首次发起还是从历史消息中重新审批。
依赖同步更新
这个补丁同时更新了若干底层依赖,包括 ai@7.0.174、@ai-sdk/provider@4.0.39 和 @ai-sdk/provider-utils@5.0.82。对使用者来说这类更新通常不需要额外改动,但如果你的项目对 peer 依赖版本敏感,升级时值得确认一下。
该不该升级
如果你正在用 @ai-sdk/workflow 搭建带人工审批环节的 Agent 工作流,这个版本值得尽快跟进——三个修复都直接关系到审批逻辑的输入准确性和权限边界的可靠性。如果你的工作流里没有用到 toolApproval,升级影响面较小,按常规补丁更新处理即可。
相关推荐

通往轨道的路:发射巨构如何终结火箭时代
从质量驱动器、天钩、发射环到轨道环,SFIA 长视频系统梳理通往轨道的发射巨构谱系,揭示交通量如何决定技术选择,以及这些方案为何终将拼成一张运输网络而非彼此竞争。

戈登·拉姆齐对决米其林父子:加利西亚美食寻味记
戈登·拉姆齐深入西班牙加利西亚,与米其林两星主厨佩佩·维埃拉展开美食对决。从死亡海岸的鹅颈藤壶到传统石炉面包,探索加利西亚独特的饮食文化与食材故事。

Soundcore Liberty 5 Pro降至历史低价:通勤通话首选真无线耳机
Soundcore Liberty 5 Pro真无线耳机降至129.99美元历史低价,原价169.99美元。这款Anker旗下声阔耳机以通话质量见长,在Amazon、Best Buy和Walmart同步促销,提供四种配色,适合通勤和线上会议用户。