@ai-sdk/workflow
Vercel AI SDK 生态中面向工作流编排的子模块,帮助开发者以结构化方式串联多个 AI 调用步骤,支持状态管理、条件分支和多步推理,与 Vercel 边缘运行时和流式响应体系原生集成
核心事实
时间轴 (近 90 天)
对于已使用 @ai-sdk/workflow 的项目,升级到 2.0.91 是低风险升级,建议在测试环境确认 ai 升级到 7.0.159 后工作流调用行为一致再推送到生产
封装层对核心包的隐式依赖风险可通过为工作流关键路径编写契约测试、升级时对核心包做差异 diff 审查、以及在锁文件中固定 ai 的精确版本来缓解
Experimental_SandboxSession 新增了 stat、listDirectory 和 deleteFile 三个方法
本次更新将 LanguageModelStreamPart 转为稳定,同时将 Experimental_LanguageModelStreamPart 标记为废弃。
patch 版本虽然语义上不包含破坏性变更,但仍建议在 CI 中跑一遍类型检查,确认废弃别名没有在新代码中被误用。
filterActiveTools 从实验命名空间中毕业,现在直接以 filterActiveTools 导出,原有的 experimental_filterActiveTools 保留为废弃别名。
建议在升级后全局搜索 experimental_ 前缀的调用,逐步迁移到稳定 API。
@ai-sdk/workflow 补丁版本频繁出现,大多不是在修自身的业务缺陷,而是在跟随核心包的发布节奏做依赖对齐。
workflow 包本身没有代码变更,版本号上跳是为了对齐依赖树。
核心包升级后,工作流包若不跟进,可能出现协议不匹配的运行时错误。
还有 40 条时间轴事件
全部知识事实 (20)
@ai-sdk/workflow 2.0.68 的唯一变更为将核心依赖 ai 升级至 7.0.136
90%已验证@ai-sdk/togetherai@3.0.51 主要变更集中在依赖项升级,未包含破坏性变更
90%已验证Patch 版本更新(1.0.104 → 1.0.105)意味着向后兼容的 bug 修复或依赖更新,不引入破坏性变更
90%已验证该发布记录由 GitHub Actions 自动化流程完成,并经过 GitHub 官方验证签名(Verified)
90%已验证补丁版本更新理论上不包含破坏性变更(Breaking Changes),升级风险较低
90%已验证@ai-sdk/workflow-harness@1.0.101 的核心内容是依赖项更新,同步升级底层依赖 @ai-sdk/harness@1.0.101
90%已验证升级方式为运行 npm install @ai-sdk/openai@4.0.60
90%已验证在 AI SDK 中,workflow-harness 负责编排和执行 AI 工作流的运行时支架,将多个 AI 调用、工具调用、状态管理等环节串联成可控的工作流
90%已验证Vercel AI SDK 采用 Monorepo 单一代码仓库管理模式,核心包 ai 与各框架适配包(如 @ai-sdk/vue、@ai-sdk/react、@ai-sdk/svelte)协同发布
90%已验证@ai-sdk/workflow 是 Vercel AI SDK 生态中专注于工作流编排的子包
90%已验证@ai-sdk/harness 与 @ai-sdk/workflow-harness 承担为 AI 工作流提供标准化运行与验证环境的职责
85%已验证本次更新将依赖 ai 升级到 7.0.102,将 @ai-sdk/provider-utils 升级到 5.0.41
80%已验证如果项目中同时锁定了 ai 和 @ai-sdk/workflow,应将两者一并更新,避免版本不匹配导致的类型或运行时错误
80%已验证@ai-sdk/workflow 提供声明式 API 来描述有向任务图,管理异步调用顺序、中间状态传递和错误重试逻辑
80%已验证@ai-sdk/vue@4.0.149 将 `ai` 包更新至 7.0.149。
75%已验证@ai-sdk/workflow@2.0.77 的发布由 github-actions 机器人自动完成,包含 3 个提交,合并到 main 分支,提交哈希为 be27bec。
75%已验证AI SDK 的分层设计中,核心包 ai 提供与框架无关的能力(模型调用、流式响应解析、工具调用编排、消息状态管理等)。
75%已验证在升级 @ai-sdk/vue 时,应同步检查 ai 包的 changelog,因为框架适配层的发布说明通常只写 Updated dependencies,真正的行为变更记录在核心包里。
75%已验证该提交使用GPG密钥ID B5690EEEBB952194签名并通过验证。
75%已验证Patch 版本升级仍有可能间接拉入新版本的深层依赖,建议在锁文件环境下运行测试
75%