SuperAPI AI 工具集

workflow

办公与效率

查看项目

更新于 10-16 07:28

技能介绍

用途:为使用 Vercel Workflow DevKit(WDK)构建持久化工作流、长时间运行任务、API 路由或需要暂停/恢复与重试的智能体提供专家指导。

主要能力:通过 "use workflow" 与 "use step" 指令将异步函数变为持久化工作流与可缓存、可重试的步骤;提供 sleep、fetch、createHook、createWebhook、getWritable、FatalError、RetryableError、getWorkflowMetadata、getStepMetadata 等原语;提供 start、getRun、resumeHook、resumeWebhook 等 API 操作;支持 Next.js、Vite、Astro、Nitro/Nuxt 等框架集成;提供 DurableAgent 用于构建可保持状态、可中断恢复的 AI 智能体。

使用方式:优先查阅 node_modules/workflow/docs/ 下的内置文档(getting-started、foundations、api-reference、ai、errors 等),相关包 @workflow/ai、@workflow/core、@workflow/next 也含内置文档。建议将逻辑放入 "use step" 函数,工作流函数仅做编排,以避免沙箱限制。工作流沙箱中无 fetch、无 setTimeout/setInterval、无 Node.js 模块,需分别用 workflow 的 fetch、sleep、步骤函数替代。

适用场景:持久化工作流、长时间运行任务、API 路由、需要暂停/恢复与重试的智能体、AI 智能体集成。

限制:工作流与步骤间传递的数据必须可序列化,不支持函数、类实例、Symbol、WeakMap/WeakSet;start() 不能在 workflow 上下文中直接调用,需包在步骤函数中;createWebhook() 始终生成随机令牌,不可传 token 选项;仅导入实际使用的 workflow API,未使用的导入可能导致 500 错误。调试可用 npx workflow health、npx workflow web、npx workflow inspect runs、npx workflow cancel 等命令;测试提供 Vitest 插件 @workflow/vitest。官方资源:https://useworkflow.dev 与 https://github.com/vercel/workflow。