如何让AI Agent定时自动干活?Luvus Agent Automation自动化调度指南:一次任务与时区感知周期任务

原创2026-10-21 20:57:132,658 阅读
文章标签:开发工具CLIAgent 编排Agent 工作流人工智能AI 应用版本控制

如何让AI Agent定时自动干活?Luvus Agent Automation自动化调度指南:一次任务与时区感知周期任务

Luvus 是一个 AI Agent 任务控制台(Mission Control),它的 Agent Automation 功能可以把任意一条提示词(prompt)变成「定时自动干活」的计划任务:到点自动拉起 Agent 执行、自动隔离工作区、自动记录运行历史,全程不需要你守在电脑前。

Luvus AI Agent 任务控制台总览,展示多个 Agent 定时任务的运行状态

什么是 Agent Automation?

简单说:你负责写清"干什么"和"什么时候干",Luvus 负责到点可靠地执行。

它和普通 cron 脚本的区别在于:

  • 任务持久化:调度定义由 Luvus 服务端持有并持久化(存于 automations.json 台账),关闭 TUI 界面不影响计划继续生效;
  • 去重与幂等:每次触发以「定义 ID + 计划时间」为唯一键,重启恢复后不会重复执行同一时刻的任务;
  • 安全边界:每次运行可限定访问级别(只读 / 工作区 / 完全访问)和运行模式(独立 worktree / 现有工作区);
  • 历史可审计:每次运行都留下状态快照,可查、可重试、可排查。

调度核心实现在 src/automation/mod.rs,时区安全的日历计算在 src/automation/schedule.rs,数据模型见 src/automation/model.rs。

4 种调度类型:一次任务、固定间隔、每日、每周

在 TUI 或 CLI 中创建时,可以选 4 种触发器(trigger):

调度类型 CLI 写法 说明
一次任务(Once) --once 2026-09-08T06:30:00Z 只执行一次,执行后自动停用
固定间隔(Interval) --every 3600 每 N 秒执行,最小 60 秒
每日(Daily) --daily 08:00 --timezone Asia/Shanghai 按指定 IANA 时区的本地时间执行
每周(Weekly) --weekly mon,wed,fri --at 09:30 --timezone Asia/Shanghai 指定星期几 + 本地时间

创建前可以先「预览未来几次触发时间」,存盘前确认无误:

luvus automation preview \
  --weekly mon,tue,wed,thu,fri \
  --at 08:00 \
  --timezone Asia/Makassar

时区感知周期任务:跨夏令时也不会"跑偏"

这是 Luvus 调度最值得称道的一点:

  • 界面会自动识别你系统使用的 IANA 时区(如 Asia/Shanghai、America/New_York);
  • 内部所有截止时间统一换算成 UTC 存储,但保留原始时区信息;
  • 每天 08:00 的任务,会在当地时钟 08:00 触发——即使跨过年初夏令时切换,墙钟时间依然稳定。

对于夏令时造成的"不存在的时刻"(如春季跳空),Luvus 会自动顺延;"重复的时刻"(如秋季回拨)则只取第一次出现。日历计算的细节与单元测试可以在 src/automation/schedule.rs 中看到。

一键创建你的第一个周期任务

一条命令创建"工作日早上只读代码审查":

luvus automation create "Weekday code review" \
  --title "Review workspace changes" \
  --prompt "Inspect the current changes. Report correctness, security, and test risks without modifying files." \
  --agent codex \
  --workspace-id workspace_example \
  --weekly mon,tue,wed,thu,fri \
  --at 08:00 \
  --timezone Asia/Makassar \
  --access read-only

仓库里还提供了一个可直接抄的完整示例脚本,含时区预览和幂等键(idempotency key)防重复:examples/automation/weekday-readonly-review.sh,用法说明在 examples/automation/README.md。

💡 幂等键技巧:给 create 加上 --idempotency-key 唯一名称,即使网络抖动导致请求重发,也只会创建一条定义,不会产生重复任务。

两种执行目标:新起 Agent,还是续上正在跑的会话?

目标 行为
New agent(默认) 每次触发都新建一个 ORCH 任务,启动全新 worker,隔离性最好
Active agent 把计划好的提示词直接投递给 Luvus 里某个正在运行的 Agent 面板,延续它当前的上下文对话

Luvus AI Agent 自动化任务的实时运行画面,展示正在执行的任务

Active agent 模式投递前会二次校验面板 ID、终端生命周期和 Agent 身份,绝不误投到别的会话;目标 Agent 忙时可以选 wait(排队等空闲)或 skip(记为跳过)。

错时触发与任务重叠策略

电脑休眠、服务重启错过触发点怎么办?两个策略旋钮:

策略 取值 行为
Misfire(错过触发) run_latest(默认) 只补跑最近一次错过,不会重放积压
skip 错过超过宽限期(默认 3600 秒)直接跳过
Overlap(任务重叠) skip(默认) 上一轮还在跑,本轮记为 skipped
queue_one 保留一个待执行任务,等上一轮结束后启动

常用管理命令速查

luvus automation list              # 查看所有定义与下次触发时间
luvus automation get a1            # 查看单个定义
luvus automation history a1 --limit 20   # 查看运行历史
luvus automation enable a1         # 启用 / 停用(disable)
luvus automation run a1            # 立即手动跑一次,不影响原计划
luvus automation health            # 汇总健康状态
luvus automation delete a1         # 删除空闲定义

完整的 CLI 与 UHP(远程协议)用法参考官方文档:website/src/content/docs/docs/guides/automation.mdx。

常见问题排查

现象 先检查什么
到点没跑 对应的 Luvus 服务端是否在运行?用 automation health 和 automation history <id> 排查
报 workspace_not_found 用 luvus workspace list 重新拿稳定的 workspace ID
运行卡在 pending Active agent 模式的 busy 策略是 wait,等目标空闲后自动投递
休眠后一次任务被跳过 查看定义的 misfire 策略和宽限期设置

写在最后

Luvus Agent Automation 把「AI Agent 定时自动干活」做成了三件小事:选好时区感知的计划 → 指定访问级别 → 交给服务端托管执行。一次任务适合"明晚 23 点跑一批测试",周期任务适合"每个工作日早上自动代码审查"——任务定义持久化、触发去重、失败可追溯,真正做到了你睡觉、Agent 干活。

登录后查看全文
luvus