Rerun 自动化实战:用定时任务(Cron)和 Webhook 触发器让 AI 同事在你睡觉时干活

原创2026-11-07 09:35:221,849 阅读

Rerun 自动化实战:用定时任务(Cron)和 Webhook 触发器让 AI 同事在你睡觉时干活

Rerun 是一款可自托管的开源 AI 同事平台(AGPL-3.0),它的核心卖点是让 AI "同事"(Coworker)像你团队里的真实成员一样使用工具、处理工作。而真正让它从"聊天机器人"变成"打工人"的,是两大自动化能力:**定时任务(Cron 调度)**和 Webhook 触发器——前者让 AI 同事按时刻表自动开工,后者让任何外部服务的 HTTP 请求都能一键唤醒它。本文将带你从零配置这两种自动化,让 AI 同事在你睡觉时继续干活。

Rerun 中的 AI 同事在夜间自动运行定时任务,凌晨起草早上的简报

为什么 AI 同事需要"自动化"

一个只会等你发消息才回复的 AI,充其量是聊天机器人。只有两样东西能让它成为真正的"打工人":

  • 定时任务(Scheduled task):标准的 5 段式 Cron 表达式 + 一段指令。到点自动执行,无需任何用户消息。
  • Webhook 触发器(Trigger):给 AI 同事一个公开 URL,谁调用它,它就带着请求负载开始干活。

两者的共同优点:每次自动化运行都会新开一个独立会话,不会插进你正在进行的对话里,并且完整记录在 Monitoring 和 Logs 中,随时可查。官方对这两者的完整说明见 automations.mdx。

一、如何创建定时任务:Cron + 指令三要素

定时任务的三要素

打开某位 AI 同事的 Scheduled runs 标签页即可添加定时任务(或者直接在聊天里让它自己帮你建)。每个任务只需要三个要素:

字段 说明
Name(名称) 决定任务被寻址时使用的 slug
Instruction(指令) 触发时发给同事的完整提示词,就像你对着它说话一样
Cron 标准 5 段式表达式,例如 0 9 * * 1 表示每周一早上 9 点

此外还可以设置 Timezone(IANA 时区,如 Europe/Paris),不设置则跟随你机器的时区。

常用 Cron 表达式速查

表达式 含义
0 9 * * * 每天早上 9 点
0 9 * * 1 每周一早上 9 点
*/30 * * * * 每 30 分钟一次
0 2 * * 0 每周日凌晨 2 点

Cron 解析逻辑在引擎端实现,源码见 cron.ts。

一次性定时任务:只跑一次

如果只想在某个特定日期跑一次(比如"周五下午 6 点发周报"),给任务一个具体日期而不是 Cron 表达式即可——触发后任务会自动禁用自己,不会重复执行。

上线前先"试跑":Run now

这是最容易被忽略但极其实用的功能:Run now 会立即触发任务,且:

  • 对已禁用的任务同样有效(方便你写好指令先禁用、测试通过再启用);
  • 不改动任务的调度计划,也不影响"上次运行"时间。

从 API 侧看,对应的工具是 run_schedule_now,详见 schedules.mdx。

省钱技巧:给夜间任务配便宜模型

每个任务可以携带自己独立的模型。例如白天对话用旗舰模型,而凌晨 2 点的清理任务跑一个更便宜的模型——不指定时沿用该同事的默认模型。

跨次运行的"连续性"

要理解的一个关键点:每次定时运行都会开一个全新会话,它不记得上周一聊了什么。真正能跨次延续的只有两样东西:Memory(记忆)和数据库。

所以如果你的任务需要"接着上次的进度干"(比如每周汇总销售数据),就在指令里明确告诉它:"把本次进度写入你的记忆/数据库"。相关概念定义见 concepts.mdx。

Rerun 的行政助理(Executive Assistant)模板,负责整理收件箱并每天早上做简报

💡 一个典型组合:用官方 Executive Assistant 模板 + 一条 0 9 * * 1-5 的定时任务,指令写"汇总昨夜新邮件、今天的日历,生成一份 9 点前的简报"——每天上班前,简报已经在等你了。

二、如何配置 Webhook 触发器:一个 URL 唤醒 AI

触发器的工作原理

触发器会给你的 AI 同事生成一个公开 URL(形如 /api/t/{agentId}/{slug}/{token})。任何能发 HTTP 请求的服务调用它,同事就会立即开始一次运行,并把对方的请求负载(payload)自动附上。没有 SDK、没有密钥交换、没有握手——这正是 Webhook 的极简之美。

在同事的 Triggers 标签页添加即可,你会得到一个可以直接粘贴进第三方服务(Stripe、GitHub、自建脚本……)的完整 URL。URL 构造逻辑见 url.ts,HTTP 入口处理见 triggers.ts。

指令要"假设事件已经发生"

写触发指令的关键技巧:把事件当作已经发生来写,例如:

"一条 Stripe 退款事件到达。把它记录到 refunds 表中,如果金额超过 500 就提醒我。"

因为调用方的 payload 会紧跟在指令后面,装在一个 <trigger_payload> 块里送达——AI 同事完全不需要自己去抓取任何数据:

读取 Stripe 的 payload,往 payments 表加一行。

<trigger_payload trigger="stripe-payment" method="POST" received="2026-08-15T09:12:04.000Z" ...>
{ "type": "payment_intent.succeeded", "data": { … } }
</trigger_payload>

JSON 会被自动美化,payload 上限 64 KB(超出截断),请求体上限 1 MB(超出返回 413)。

安全须知:URL 本身就是凭证

⚠️ 这是所有资料里反复强调的一点:触发器 URL 就是密码。没有签名校验、没有密钥头、没有白名单——谁拿到这个 URL,谁就能无限次唤醒你的 AI 同事。

  • 不要把它粘进共享文档、工单或公开仓库;
  • 一旦泄露,在 Triggers 标签页或通过 rotate_trigger_token 轮换(旧 URL 立即失效,记得同步更新所有已配置的服务);
  • 默认只接受 POST。如果开启 GET,链接预览、爬虫理论上也可能触达该 URL(Rerun 会过滤已知的预览器,但 POST 单独开放永远是最安全的默认值)。

完整 HTTP 契约(方法、响应码、被动访问过滤等)见 webhooks.mdx。

如何测试触发器

两种试跑方式:

  1. 用 curl 直接 POST 一个样例负载到触发器 URL;
  2. 使用 test_trigger 工具——它会预先检查方法与启用状态,给你可读的错误而不是干巴巴的 404。

注意:无论哪种方式,这都是一次真实触发,会计入触发次数。拿到返回的 runId 后,用 get_run 即可查看运行结果,详见 triggers.mdx。

Rerun 的 Foreman(工头)帮你管理整个 AI 同事团队,并支持 Autopilot 自动值守

三、无人值守运行:半夜它也能"停下来问你"

这是 Rerun 自动化设计中最有人情味的一点:凌晨 3 点的自动化运行,照样可以中途暂停向你提问或请求审批。

  • 运行会暂停,你会收到通知(应用内 + 邮件);
  • 你什么时候回复,它就从你的答案处继续;
  • 这是刻意的设计——同事不应因为"没人盯着"就跳过审批。

建议把自动运行(scheduled/webhook 触发)的通知渠道设为邮件,这样凌晨的审批请求才能真正找到你。详细机制见 human-in-the-loop.mdx。

四、定时任务还是 Webhook?一张表选对工具

你的需求 推荐方案
每天早上 / 每周一 / 每小时执行 ✅ 定时任务
其他服务说"该干活了"才执行 ✅ Webhook 触发器
只在某个日期执行一次 ✅ 一次性定时任务
自己的脚本按需调用 ✅ 触发器,或 send_message

两种自动化都可以通过 API 完整管理(upsert_schedule / upsert_trigger),这意味着你可以把自动化配置纳入版本控制——配置即代码。

五、去哪里看运行结果

Rerun 团队看板:左侧是所有 AI 同事的实时状态,右侧是与其对话并查看执行细节

每次自动化运行(无论定时还是 Webhook)都会记录完整的步骤、工具调用、token 消耗和成本,在同事的 Monitoring 与 Logs 标签页查看,也可以通过 get_run / list_runs 从 API 读取。

总结

  • 定时任务 = Cron + 指令 + 时区,支持一次性执行、独立模型、Run now 试跑;
  • Webhook 触发器 = 一个公开 URL,payload 自动注入,URL 即凭证务必妥善保管;
  • 人在环中 = 无人值守运行也会暂停等你审批,重要操作永不越权;
  • 跨次连续性靠 Memory 和数据库,在指令里明确让它"记下来"。

核心模块路径速查:

把重复的劳动交给 Cron 和 Webhook,你的 AI 同事会比你更准时地打卡。🌙

登录后查看全文
rerun