跳转到内容
MagicAI 工作流 MagicAI 工作流

定时任务

定时任务用于让已经调试通过的工作流按周期自动运行。它不是用来“修复不稳定流程”的——只有已经手动运行稳定的工作流，才适合交给定时任务无人值守。

定时任务

适合定时跑的任务

Section titled “适合定时跑的任务”
适合不适合
每日报表、数据同步第一次搭、还没跑通的工作流
定时巡检、健康检查调用支付、提交、删除、发货且无回滚
周期生成日报 / 周报强依赖验证码或频繁登录
固定时间发送通知输出格式还在变化
周期清理 / 归档缺日志或没人维护

主流程：把一个工作流变成定时任务

Section titled “主流程：把一个工作流变成定时任务”

步骤 1：先确认上线前的前置条件

Section titled “步骤 1：先确认上线前的前置条件”

一律先用这份清单自检：

[ ] 工作流已经发布版本，不是用草稿
[ ] 至少手动成功运行过 1～2 次
[ ] 输出字段稳定，命名清晰
[ ] 关键失败有 try-catch 或异常分支
[ ] 凭据通过「连接」管理，不是写死在节点里
[ ] 风控 / 频次 / 数据量已评估
[ ] 出错时能找到负责人和告警渠道

不全打勾就先别配定时。

步骤 2：进入定时任务并新建

Section titled “步骤 2：进入定时任务并新建”
  • 在左侧导航选 定时任务，点击 新建。
  • 选择要调度的工作流（必须是已发布版本）。
  • 选择对应版本号（建议固定到具体版本，避免线上行为随意变）。
定时任务

步骤 3：配置触发周期

Section titled “步骤 3：配置触发周期”

常见周期写法：

想要配置方式
每天 09:30每日 / 09:30，或 Cron 30 9 * * *
每周一 08:00每周一 / 08:00，或 Cron 0 8 * * 1
每小时 5 分Cron 5 * * * *
每 15 分钟Cron */15 * * * *
工作日 18:00Cron 0 18 * * 1-5

注意点：

  • 时间通常按客户端 / 工作空间所在时区。第一次配完先看一次“下次执行时间”是否符合预期。
  • 不要在每天同一秒钟配几十个任务，错开几分钟，避免同时打爆下游。
  • 高频任务（< 5 分钟）必须配合超时和重试上限。
定时任务

步骤 4：配置输入参数和失败兜底

Section titled “步骤 4：配置输入参数和失败兜底”
  • 输入参数：定时跑通常用默认值，或基于时间生成（例如“昨天日期”）。
  • 失败处理：能 try-catch 的在工作流里 try-catch；定时任务层面再配置：
    • 失败重试次数（建议 1～3）。
    • 重试间隔（建议指数退避，例如 30s / 2m / 10m）。
    • 失败告警通道（飞书 / 邮件 / Webhook）。
定时任务

步骤 5：先“立即运行一次”再开启周期

Section titled “步骤 5：先“立即运行一次”再开启周期”

不要直接启用周期。先点 立即运行一次：

  • 看运行日志：每个节点是否成功。
  • 看输出：是否和手动运行结果一致。
  • 看告警：故意配错一次（比如临时关掉一个连接），确认能收到失败告警。
定时任务

成功标准：单次执行 100% 符合预期，再启用周期开关。

步骤 6：上线后的日常维护

Section titled “步骤 6：上线后的日常维护”

定时任务上线后不是“点一下就完事”：

  • 每周看一次执行成功率 / 日志。
  • 凭据更换时同步更新 连接，并触发一次手动运行验证。
  • 工作流升级版本时，定时任务里要显式切到新版本，不要默认跟随。
  • 任务长期不再用，及时关停或删除，避免“僵尸定时”。

常见周期编排建议

Section titled “常见周期编排建议”
  • 每日报表：放在数据可获取后 30 分钟，例如数据 09:00 出，定时 09:30 跑。
  • 巡检：高频但要轻量，5～15 分钟一次，单次执行控制在数秒。
  • 周期同步：错峰，避免和其他高峰任务挤同一时刻。
  • 跨日任务：注意时区切换、月底跨月、节假日是否需要跳过。

卡住了？

Section titled “卡住了？”
你遇到的情况处理方式
没有定时任务入口检查账号权限，必要时联系管理员
任务到点没触发看任务是否启用、上次执行状态、客户端是否在线
任务一直失败看运行日志定位失败节点；检查 连接 是否过期
没收到失败告警检查告警通道、接收人、Webhook 是否仍然有效
跑得太频繁触发风控降低频率、加人机校验白名单、错峰执行

下一步

Section titled “下一步”