SuperAPI AI 工具集

inngest-events

设计与创作

查看项目

更新于 10-15 23:34

技能介绍

用途:该技能用于设计和发送 Inngest 事件,事件是 Inngest 的基础,用于触发函数。内容聚焦 TypeScript,Python 或 Go 需参考 Inngest 官方文档,核心概念跨语言通用。

主要能力:事件负载格式(必填 name、data,可选 id、ts、v);命名规范采用 domain/noun.verb 的对象-动作模式,如 billing/invoice.paid;用 id 实现幂等去重,去重窗口为首次接收后 24 小时;用 ts 参数延迟投递或维持事件顺序;扇出模式让一个事件触发多个独立函数并行执行;系统事件用于监控函数生命周期,如 inngest/function.failed、inngest/function.finished、inngest/function.cancelled。

使用方式:通过 inngest.send() 发送单个或批量事件(批量上限 512kb),返回事件 ID 便于追踪;在函数内部应使用 step.sendEvent() 以获得可靠性与去重;可用 step.waitForEvent 等待其他事件完成,配合 Promise.all 编排流程。生产环境需设置 INNGEST_EVENT_KEY 环境变量。

适用场景:用户注册后触发欢迎邮件、创建试用订阅、同步 CRM 等扇出流程;支付、订单、库存等业务事件驱动;失败函数的日志、告警与自动重试。

限制:资料未提供具体收费、价格与平台支持细节;示例为 TypeScript,其他语言需查阅官方文档;事件 schema 发送后不应修改,需用 v 字段做版本管理。