SuperAPI AI 工具集

trigger-dev

编程与开发

查看项目

更新于 11-17 18:42

技能介绍

Trigger.dev 技能面向使用 TypeScript 构建生产级后台任务、工作流和自动化的开发者,基于 Trigger.dev v4 提供代码模式与工程约束指导。

用途:帮助编写代码优先(code-first)的后台作业,包括任务定义与触发、定时调度、重试与错误处理、并发与队列控制、幂等与等待、可观测性及部署配置。资料说明,如需可视化工作流应使用 n8n。

主要能力:

  • 基础任务:使用 task 定义任务,包含唯一 id 与异步 run 函数。
  • Schema 校验任务:使用 schemaTask 配合 zod 对 payload 进行类型化与校验。
  • 定时任务:使用 schedules.task 配置 cron 表达式,回调中可获取 timestamp、lastTimestamp、timezone。
  • 触发方式:可从后端用 tasks.trigger 触发任务(配合 type-only 导入任务类型),也可在任务内用 triggerAndWait 调用其他任务并等待结果。
  • 稳定性控制:提供并发、重试、错误、幂等、wait 函数、AbortTaskRunError 等机制。
  • 运行观测:涉及 runs、tags、metadata、logger、streams、query 等 SDK 能力。
  • 机器规格:micro(0.25 vCPU / 0.25 GB)、small-1x 默认(0.5 / 0.5 GB)、small-2x(1 / 1 GB)、medium-1x(1 / 2 GB)、medium-2x(2 / 4 GB)、large-1x(4 / 8 GB)、large-2x(8 / 16 GB)。

使用方式(资料给出的核心步骤):

  1. 安装依赖:npm add @trigger.dev/sdk@latest 与 npm add -D @trigger.dev/build@latest。
  2. 在项目根目录创建 trigger.config.ts,使用 defineConfig({ project: "<ref>", dirs: ["./src/trigger"] }),配置文件不能嵌套。
  3. 在 .env 中添加 TRIGGER_SECRET_KEY。
  4. 在配置的目录中创建任务文件并导出任务。
  5. 本地开发运行 npx trigger.dev@latest dev,部署运行 npx trigger.dev@latest deploy。

适用场景:TypeScript 项目中的后台作业、定时清理、后端触发的异步流程、任务间的编排与等待、需要并发与重试控制的自动化,以及涉及 AI 集成、流式传输与实时能力的任务。

限制与关键规则:任务 ID 全项目唯一;payload 与返回值必须可 JSON 序列化,不能包含类、函数或循环引用;任务需导出,未导出会变为隐藏/仅内部可用;从后端触发时使用 type-only 导入;永久性错误使用 AbortTaskRunError 以避免重试;等待期间任务会 checkpoint,不计计算费用;并发限制只统计正在执行的运行;每次运行最多 10 个 tag、256KB metadata,批量最多 1000 项;重试时可在任务内用 idempotencyKeys.create() 防止重复触发子任务。

质量要求:代码需编译并通过测试与类型检查且无新增警告;显式处理边界条件与错误状态;不引入硬编码密钥;不削弱或跳过失败测试,不静默吞掉错误,破坏性 API 变更需版本升级与迁移路径。资料的官方文本未提供,收费、价格与具体平台支持等信息暂未提供。