Rerun 自动化实战:用定时任务(Cron)和 Webhook 触发器让 AI 同事在你睡觉时干活
Rerun 自动化实战:用定时任务(Cron)和 Webhook 触发器让 AI 同事在你睡觉时干活
Rerun 是一款可自托管的开源 AI 同事平台(AGPL-3.0),它的核心卖点是让 AI "同事"(Coworker)像你团队里的真实成员一样使用工具、处理工作。而真正让它从"聊天机器人"变成"打工人"的,是两大自动化能力:**定时任务(Cron 调度)**和 Webhook 触发器——前者让 AI 同事按时刻表自动开工,后者让任何外部服务的 HTTP 请求都能一键唤醒它。本文将带你从零配置这两种自动化,让 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。
💡 一个典型组合:用官方 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。
如何测试触发器
两种试跑方式:
- 用
curl直接 POST 一个样例负载到触发器 URL; - 使用
test_trigger工具——它会预先检查方法与启用状态,给你可读的错误而不是干巴巴的404。
注意:无论哪种方式,这都是一次真实触发,会计入触发次数。拿到返回的 runId 后,用 get_run 即可查看运行结果,详见 triggers.mdx。
三、无人值守运行:半夜它也能"停下来问你"
这是 Rerun 自动化设计中最有人情味的一点:凌晨 3 点的自动化运行,照样可以中途暂停向你提问或请求审批。
- 运行会暂停,你会收到通知(应用内 + 邮件);
- 你什么时候回复,它就从你的答案处继续;
- 这是刻意的设计——同事不应因为"没人盯着"就跳过审批。
建议把自动运行(scheduled/webhook 触发)的通知渠道设为邮件,这样凌晨的审批请求才能真正找到你。详细机制见 human-in-the-loop.mdx。
四、定时任务还是 Webhook?一张表选对工具
| 你的需求 | 推荐方案 |
|---|---|
| 每天早上 / 每周一 / 每小时执行 | ✅ 定时任务 |
| 其他服务说"该干活了"才执行 | ✅ Webhook 触发器 |
| 只在某个日期执行一次 | ✅ 一次性定时任务 |
| 自己的脚本按需调用 | ✅ 触发器,或 send_message |
两种自动化都可以通过 API 完整管理(upsert_schedule / upsert_trigger),这意味着你可以把自动化配置纳入版本控制——配置即代码。
五、去哪里看运行结果
每次自动化运行(无论定时还是 Webhook)都会记录完整的步骤、工具调用、token 消耗和成本,在同事的 Monitoring 与 Logs 标签页查看,也可以通过 get_run / list_runs 从 API 读取。
总结
- 定时任务 = Cron + 指令 + 时区,支持一次性执行、独立模型、
Run now试跑; - Webhook 触发器 = 一个公开 URL,payload 自动注入,
URL 即凭证务必妥善保管; - 人在环中 = 无人值守运行也会暂停等你审批,重要操作永不越权;
- 跨次连续性靠 Memory 和数据库,在指令里明确让它"记下来"。
核心模块路径速查:
- 自动化概念:apps/docs/agents/automations.mdx
- 定时任务引擎:apps/engine/src/schedules/
- Webhook 触发器引擎:apps/engine/src/triggers/
- 触发器 HTTP 路由:apps/engine/src/http/routes/triggers.ts
把重复的劳动交给 Cron 和 Webhook,你的 AI 同事会比你更准时地打卡。🌙



