Workflow SDK 5发布:为生产环境打造的持久化工作流引擎

Workflow SDK 5 围绕加密、区域化与引擎重写,将持久化执行推向生产级 Agent 负载。
Workflow SDK 5 是基于超过 40 亿步骤、7 亿次运行观察做出的系统性升级,围绕安全、可靠性和性能三条主线展开。安全方面,事件日志载荷在离开代码前即用 AES-256-GCM 加密,Vercel 上零配置,自托管 World 通过 getEncryptionKeyForRun 实现,可观测性通过本地解密保留。可靠性方面,运行从固定 iad1 迁移到区域化部署,每次运行有归属区域,热路径消除跨区往返,故障切换时状态仍固定在归属区域。性能方面,引擎重写减少队列跳转并引入增量重放,官方基准中步骤间开销 p75 从 618 ms 降至 109 ms,1,020 步骤完成中位时间从 21.0 分钟降至 3.0 分钟,WebSocket 流式传输将 52.4 秒 Agent 响应的中位交付时间从 226.1 秒降至 53.5 秒。World 作为共享持久化底座同时支撑 fx、durable-harness 等 Agent 工具。
从实验到生产:Workflow SDK 的转折点
Workflow SDK 最初的目标很朴素:用普通的异步 JavaScript 写业务逻辑,剩下的交给 SDK 去处理崩溃恢复、部署切换和长时间等待。一个 sleep("3d") 就能让函数跨越三天继续执行,这曾经是它最直观的卖点。
在积累了超过 40 亿个步骤和 7 亿次运行之后,团队观察到了两类清晰的使用模式:一是传统自动化,包括数据流转、订单处理、后台任务编排、订阅管理和 ETL 管道;二是 Agent 与 harness,因为 Agent 运行时间长、成本高,天然需要持久化能力。Workflow SDK 5 正是围绕这两类负载的成熟需求做出的系统性升级,核心关注点落在安全、可靠性和性能三条线上。
持久化执行(Durable Execution) 是理解 Workflow SDK 的基础概念。传统函数一旦进程崩溃或部署切换,内存中的执行状态就会丢失,长任务必须从头重跑。持久化执行的做法是把每一步的输入、输出和进度写入事件日志(event log),运行时在恢复时按日志重放已完成步骤、跳过副作用,从中断点继续。这让 sleep("3d") 这类跨越数天的等待成为可能——等待期间不占用计算资源,到期后由调度器重新唤起。代价是每一步都要与存储和队列交互,因此日志大小、跳转次数和序列化开销直接决定系统性能上限,这也是 SDK 5 重写引擎的根本动机。
端到端加密:事件日志不再裸奔
Workflow 的事件日志需要存储步骤参数和返回值,才能在崩溃或部署后恢复运行。这些数据里可能包含客户敏感信息、模型上下文、凭证和工具调用结果。SDK 5 的做法是在数据离开代码之前就完成加密:工作流与步骤的输入输出、hook 载荷以及流数据全部使用 AES-256-GCM 加密,每次运行使用独立密钥。加密开启后,包括 Vercel 在内的任何后端只能看到和存储密文,明文只在你的部署环境或授权的可观测工具中解密。
在 Vercel 上这项能力零配置生效,密钥由部署作用域派生,一次运行只能解密自己的数据,业务代码不需要任何改动。可观测性也没有被牺牲:名称、耗时和状态始终可见,需要查看载荷时可以在仪表盘或 CLI 中解密,解密发生在浏览器或终端本地,权限与项目的环境变量一致,每次请求都会记入团队的审计日志。
对于自托管 World,加密能力实现在 SDK 层。自定义 World 只需实现 getEncryptionKeyForRun(),为每次运行返回稳定的 32 字节密钥,SDK 就能在写入存储、队列或流之前完成加密,并在重放时解密。跨运行写入同样被保护:当代码恢复另一个运行的 hook、启动另一个部署中的运行,或写入从其他运行转发来的流时,载荷会加密到目标运行的公钥上,写入方无需读取目标运行已有的载荷。此外,通过将 payload retention 设置为 experimental_retention: 0,可以在运行完成或失败后立即删除输入、输出和流内容,只保留可观测性所需的元数据。
AES-256-GCM 是一种带认证的对称加密算法:256 位密钥提供高强度机密性,GCM 模式同时生成认证标签,任何对密文的篡改都会在解密时被检测到。它适合事件日志这种"写一次、多次读取"的场景,加解密开销低、支持流式处理。文中"每次运行使用独立密钥"意味着密钥派生通常基于部署作用域与运行 ID,形成层级结构:即使单次运行的密钥泄露,也无法解密其他运行的数据。跨运行写入时"加密到目标运行的公钥"则说明系统采用了混合加密——用非对称密钥封装对称密钥,使写入方能在不持有目标运行解密权限的前提下安全投递载荷。
区域化运行与可靠性加固
在 SDK 4 中,所有运行都住在 iad1。即使项目部署在多个区域,每次运行的事件日志、队列和流也只存在一个区域,其他区域执行的步骤必须跨区请求来记录进度。SDK 5 将工作流基础设施部署到了每一个 Vercel Function 区域:每次运行有自己的归属区域,状态、队列调度和流都由启动它的区域提供服务,热路径上不再有跨区往返。
默认情况下,运行在启动它的函数所在区域开始,部署到多区域后,每次运行自然贴近触发它的用户,无需配置。需要把运行放到别处时,可以给 start() 传入 region 参数,例如让工作流跑在它读写的数据库旁边,或将客户数据留在合规要求的区域。需要注意的是,region 决定的是运行数据存放的位置,步骤本身仍在应用部署的区域执行。
区域隔离也带来了可靠性收益:一个区域的中断不必阻止健康区域启动新运行。配置了 Vercel Function failover 的项目,可以在回退区域执行步骤,同时继续使用原归属区域保存状态——状态始终固定在归属区域,故障切换时不会迁移。团队还借助匿名遥测和客户协作,修复了运行时中数十个罕见 bug 和竞态条件,SDK 对间歇性网络错误的自我恢复能力也有所增强。按官方说法,SDK 5 中因平台或运行时 bug 导致的运行失败或停滞已几乎不再出现。
面向 Agent 的性能重写
SDK 4 的每次步骤调用都要经过队列跳转:一次启动步骤,一次继续工作流。这对慢速后台自动化可以接受,但对今天开发者构建的 AI 负载来说就是额外延迟。Agent 循环和 harness 可能包含数千个顺序事件、高吞吐的 token 流、工具链和动态子 Agent,在这个量级下,每次步骤周围的网络和 CPU 开销成了瓶颈。
SDK 5 重写了引擎的大部分实现,减少多余的队列跳转、不必要的网络请求和 CPU 工作。在测量的负载中,延迟和开销改善了 1.6 倍到 25 倍,开发者体验保持一致,也没有重大破坏性变更。官方在 Vercel 上对比了 v5.2.0 与 v4.8.12,测量时间为 2026 年 10 月 8 日,区域为 iad1,步骤输入输出各 1 KB JSON。
关键改动包括三项。第一,减少队列跳转:一次调用可以在让出之前内联执行多个步骤,包括并行步骤;运行时还避免了不必要的持久化往返,将步骤创建折叠进执行过程。在五步骤基准中,步骤间开销的 p75 从 618 ms 降到 109 ms。第二,增量重放:在 1,020 步骤的基准中,v4 的 p75 开销随事件日志增长,最终采样区间达到 1,748 ms,而 v5.2.0 为 70 ms;完成全部 1,020 个步骤的中位时间从 21.0 分钟降到 3.0 分钟。第三,WebSocket 流式传输:在 Vercel World 上,v5.2.0 默认通过 WebSocket 写流,在一个重放 52.4 秒 Agent 响应的基准中,中位交付时间从 226.1 秒降到 53.5 秒。需要说明的是,这衡量的是已录制响应的交付速度,而非模型生成速度的加快。
载荷压缩进一步降低了存储和传输的数据量,AI token 流压缩后平均缩小约 80%。官方也提醒,这些数据描述的是单一区域、单一负载、针对 Vercel World 的测量结果,适合作为运行时开销的参考,而不是对每个应用的预测。
增量重放(Incremental Replay) 是 SDK 5 性能改善的关键机制。SDK 4 在恢复运行时需要从事件日志头部开始重放全部历史,日志越长,每次步骤调用的开销越大,呈现随运行时长线性上升的劣化曲线。增量重放则维护已处理位置的游标,只重放自上次检查点以来新增的事件,使单步开销与总步骤数解耦。这正是 1,020 步骤基准中 v4 的 p75 从早期区间一路攀升到 1,748 ms、而 v5.2.0 稳定在 70 ms 的原因——前者是 O(n) 累积,后者近似 O(1)。对包含数千个顺序事件的 Agent 循环而言,这一差异直接决定了长会话是否可行。
World:共享的持久化底座
Workflow SDK 的持久化函数建立在 World 之上:它是存储进度、调度工作和交付流的接口。同一个底座现在也支撑 fx 和 durable-harness,为已有的 Agent harness 增加持久化能力。共享存储、队列和流式基础设施的改进可以让任何 World 消费者受益,而工作流重放运行时的优化只适用于 Workflow SDK,不会自动作用于所有 harness。
团队给出了按构建方式选择集成的路径:Workflow SDK 用于编写带 use workflow 和 use step 的持久化应用逻辑;WorkflowAgent 通过 @ai-sdk/workflow 在 workflow 内运行 AI SDK 的 Agent 循环;fx 用于嵌入和扩展基于 libfx 的原生编码 Agent;durable-harness 在现有受支持的 harness 下增加持久化,支持 Pi 和 OpenCode,并对 Vercel Sandbox 中的 Claude Code 和 Codex 提供实验性集成;eve 则用 Workflow SDK 和 Worlds 原生驱动持久化会话。官方表示后续还会扩充由 Worlds 提供持久化能力的 SDK 和框架目录。
World 可以理解为 Workflow SDK 的可插拔后端抽象:它定义了存储事件日志、调度队列任务、交付流数据这三类原语,把"持久化"从运行时中剥离出来。Vercel World 是官方托管实现,自托管 World 则允许团队接入自己的数据库与消息队列。由于重放运行时、加密、压缩等能力位于 World 之上,共享同一 World 的 fx、durable-harness 等工具能直接获得存储与流式基础设施的改进,但不会自动继承 Workflow SDK 特有的引擎优化——这一分层解释了文中"哪些改进惠及所有消费者、哪些只作用于 Workflow SDK"的区分。
其他更新与上手方式
SDK 5 还增加了基于 AbortController 的运行中取消、可搜索的运行属性、更多框架集成等能力。升级文档覆盖了具体变更点,新项目可以直接安装最新版 SDK 开始构建。Python SDK 也已进入 beta,提供相同的持久化工作流、步骤、sleep 和 hook 能力。对于已经在使用 SDK 4 的团队,现有运行会继续留在 iad1,迁移节奏可以自行把控。
相关推荐

Gemini 4 Neon 曝光:或成 Opus 5.5 有力竞争者
Hacker News 讨论帖指出 Gemini 4 Neon 看起来像 Opus 5.5 的竞争者。本文解读这一社区信号背后的产品定位、顶级模型竞争格局变化,以及对开发者模型选型策略的实际意义。

Claude Fable 5.2 独立创作短片《Fable》引热议
Hacker News 上出现由 Claude Fable 5.2 独立完成剧本、画面与导演的短片《Fable》,本文分析全流程 AI 创作的意义、社区反应及对内容创作者的启示。

Anthropic IPO定价:AI巨头上市信号
Anthropic 进行 IPO 定价的消息引发关注。本文分析这一动作对 AI 行业估值、商业化路径和竞争格局的潜在影响,并指出公开市场对 AI 公司的期待与挑战。