AgentRQ定时任务实战:Cron调度让AI Agent全天候自动执行重复工作

原创2026-10-14 19:26:111,411 阅读

AgentRQ定时任务实战:Cron调度让AI Agent全天候自动执行重复工作

AgentRQ 是一款自托管的 AI Agent 实时协作任务管理器,支持 Human-in-the-loop 的人机协作模式。它的内置 Cron 定时任务功能,可以把"每天 9 点汇总邮件摘要""每小时巡检一次服务器"这类重复工作交给 AI Agent 全天候自动执行——你只需定义一次任务,Agent 就会按计划自动运行、产出结果,人可以在任意时间从 Web、桌面端或浏览器插件查看进度。

AgentRQ 概览:在浏览器中实时查看 AI Agent 会话与 WebMCP 工具状态

为什么 AI Agent 需要 Cron 定时调度?

很多重复性工作靠"手动喊一声"效率很低:

  • 📧 每日例行:整理邮件、生成日报、检查 GitHub 通知
  • 🔁 高频巡检:监控报错日志、刷新数据看板
  • 📅 周期提醒:每周例会纪要、每月账单核对

手动触发不仅费时,还容易漏。AgentRQ 的定时任务让你把一句自然语言需求("检查我的收件箱并总结重要邮件")配上 Cron 表达式,Agent 就会不眠不休地按计划执行——你睡觉的时候,它也在干活。

AgentRQ 定时任务是怎么工作的?

原理并不复杂,理解三点即可:

① 模板任务 + 自动生成的运行实例

带 Cron 表达式的任务状态为 cron,它本身是一个"模板"。每到计划分钟,调度器会自动派生出一个子任务(run),继承模板的标题、正文和指派 Agent。重复调度会持续生成新实例,所有历史运行都能追溯查看。

② 分钟级触发,多实例防重复

后端调度器每分钟轮询一次所有 cron 任务,用标准 5 段式 cron 解析器计算下次执行时间,命中当前分钟就触发。核心逻辑在 scheduler.go。即使部署了多个后端实例,数据库索引也会保证同一分钟只创建一个 run,不会重复执行。

③ 一次性任务自动"消耗"

如果 Cron 表达式的"日"和"月"都是固定值(例如 0 9 15 10 *,10 月 15 日 9 点),系统会识别为一次性任务:到点直接运行模板本身,执行后不再重复。适合"周五 18:00 提交周报"这类单次安排。

三步快速配置 AI Agent 定时任务

第 1 步:新建任务并选择调度类型

在 AgentRQ 的 Web 界面点击 New Task,填写任务标题和正文(用自然语言描述 Agent 要做什么)。表单中的调度区域提供三种模式:

  • No Schedule:普通任务,手动触发
  • One-time:选择日期和时间,只执行一次
  • Repeated:选择重复频率,按 Cron 计划循环执行

调度表单的实现见 TaskFormView.vue。

第 2 步:选择预设频率

重复模式下内置了常用预设,无需手写表达式:Every 15m、Every 30m、Hourly、Every 2h、Daily at xx:xx、Weekly、Monthly 等。也可以指定具体小时(支持"每天两次"这类多时点组合)。

第 3 步:确认下次运行时间

表单会实时显示生成的 Cron 表达式和下次运行时间(自动转换为你的本地时区显示)。确认无误后保存,任务会出现在任务列表的 SCHEDULED 分区中。

AgentRQ 定时任务界面:任务列表中的 SCHEDULED 分区展示 AI Agent 的 Cron 调度计划

Cron 表达式速查表:常见调度配置一览

AgentRQ 使用标准 5 段式 cron(分 时 日 月 周),按 UTC 时间计算,界面会显示本地化时间。常用配置如下:

场景 Cron 表达式 说明
每 15 分钟 */15 * * * * 高频巡检
每小时整点 0 * * * * 数据刷新
每天 9:00 0 9 * * * 早间日报
每天两次 0 9,21 * * * 早晚报
每周一 9:00 0 9 * * 1 周例会准备
每月 1 号 9:00 0 9 1 * * 月度账单核对
一次性(10月15日 9:00) 0 9 15 10 * 单次到期自动执行

表达式的解析与展示逻辑在 useCron.js 中,它还能把 0 9 * * * 这类表达式转译为 Daily at 09:00 这样人类友好的文案。

查看运行实例与执行记录

点击 SCHEDULED 分区中的任意定时任务,进入运行实例页面(ScheduledTaskInstancesView.vue):

  • RUNS 徽章:显示调度频率(如 DAILY)
  • NEXT RUN:下次运行时间
  • 历史 run 列表:每一次自动执行都是一个独立任务,点开就能看到 Agent 当次的完整对话与产出

也就是说,定时任务不是"黑盒跑一下",而是每次运行都有完整的 Human-in-the-loop 会话记录,随时可以人工介入、追问或纠正。

AgentRQ 浏览器插件任务队列:手机端尺寸随时查看 AI Agent 的 ONGOING 与 SCHEDULED 任务

即使不在电脑前,也能通过浏览器工具栏弹窗随时查看正在执行(ONGOING)和已排期(SCHEDULED)的任务,给 Agent 补一句指示、回答它的提问。

让 Agent 自己创建定时任务:内置安全护栏

除了手动配置,AgentRQ 还允许 AI Agent 通过 MCP 工具自行创建定时任务(传入 cron_schedule 参数即可)。考虑到 Agent 的自我调度风险,系统内置了更严格的护栏:

  • 分钟字段必须是 0–59 的固定整数,即最粗粒度为每小时(0 9 * * * 合法,*/5 * * * * 会被拒绝)
  • 创建、修改时都会经过统一校验,规则见 cron.go

此外,AgentRQ 的扩展(Extensions)机制支持在代码中声明式地注册 Cron 任务,由宿主程序与服务器自动对齐(创建缺失的、修订漂移的、清理不再声明的),重装不产生重复、卸载不残留。详见 docs/agents/mcp-and-tasks.md 与 docs/EXTENSIONS.md 的 schedules 章节。

5 个全天候自动化的实战场景

# 场景 建议频率 任务正文示例
1 邮件摘要 0 9 * * * 每天 "整理未读邮件,按重要程度总结 Top 5"
2 服务器巡检 0 * * * * 每小时 "检查最近 1 小时的错误日志,有异常则汇报"
3 竞品动态 0 9 * * 1 每周一 "搜索本周 X 产品的更新动态并生成简报"
4 数据备份核对 0 3 * * * 每天凌晨 "确认备份任务是否成功,失败则提醒我"
5 单次提醒 一次性日期 "周五 18:00 提醒我提交周报"

使用小贴士:

  • ✅ 任务正文写得越具体,Agent 自动执行的产出越稳定
  • ✅ 高频任务建议开启 allowAllCommands 之外的最小权限,保持 Human-in-the-loop 审批
  • ⚠️ 时间按 UTC 计算,创建时留意界面显示的本地化"下次运行时间"

总结

AgentRQ 的定时任务让 AI Agent 从"随叫随到"升级为"按计划值班":

  1. 模板 + 实例的设计让每次自动执行都可追溯、可人工介入
  2. 预设频率 + 本地化时间显示,新手无需死记 Cron 语法也能快速上手
  3. 多实例防重复 + Agent 自调度的粒度护栏,兼顾可靠与可控

搭配自托管部署,数据与 Agent 都掌握在自己手里。把重复劳动交给 Cron 调度,把注意力留给真正需要人类判断的事。

登录后查看全文
agentrq