SuperAPI AI 工具集

inngest-steps

通用与其它

查看项目

更新于 10-15 22:38

技能介绍

用途:用 Inngest 的 step 方法构建持久、可重试、可观测的工作流,主要面向 TypeScript(Python、Go 请参考官方文档)。核心概念是每个 step 都是一次独立 HTTP 请求,函数会从头重跑,因此所有非确定性代码(API 调用、数据库查询、随机数)必须放进 step 内,不能放在外面。限制:每个函数最多 1000 个 step,单步输出 4MB,单次运行总计 32MB。

主要能力:step.run() 执行可重试代码并返回数据,循环中可复用 step ID,计数器自动处理;step.sleep() 按 "24h"、"30s"、"7d" 等时长暂停且不占计算资源;step.sleepUntil() 等到指定时间;step.waitForEvent() 等待事件,只能捕获该 step 执行之后发送的事件,必须设置 timeout 并处理 null 返回,支持 match 或 CEL 表达式(event 为触发事件,async 为被匹配事件);step.waitForSignal() 用于 1:1 信号匹配,需指定 onConflict("replace" 或 "fail");step.sendEvent() 触发其他函数但不等待结果;step.invoke() 调用其他函数并获取结果,v4 起不再支持字符串函数 ID,需用导入的函数引用或 referenceFunction()。

用法与模式:用 Promise.all 并行执行 step,v4 默认优化并行;Promise.race() 会等所有 promise 结束,真正竞速需用 group.parallel();可通过 optimizeParallelism: false 在客户端或函数级关闭优化。分块批处理时按块并行 step.run 再合并结果。

适用场景:人工审批、多步引导、数据处理、外部集成、AI 工作流、函数组合等。注意:step 外代码每次执行都会重跑;waitForEvent 不捕获之前的事件;生产环境务必设置超时。