[控场AI]
· 4 分钟阅读· 2,047 字

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

@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 工作流建议尽快升级。

rss source: @ai-sdk/workflow@2.0.106

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,升级影响面较小,按常规补丁更新处理即可。

#@ai-sdk/workflow#WorkflowAgent#toolApproval#AI SDK#工具审批#runtimeContext#AI Agent 工作流
分享:

相关推荐