让AI替你定时干活:Agora自动化任务与对话循环完全指南
让AI替你定时干活:Agora自动化任务与对话循环完全指南
Agora 是一款开源的 Android BYOK LLM 客户端,除了多供应商接入与 Agent 工作流外,它还提供了一套完整的**自动化任务(Tasks)与对话循环(Loops)**能力:你可以把提示词存成定时任务,让 AI 在指定时间自动执行,也可以让某个对话按固定间隔持续"干活"。本文带你快速上手 Agora 自动化,从创建任务、配置排程到后台执行的注意事项,一文讲清。
🕒 Agora 自动化能做什么?
打开 设置 → 自动化(Automation),即可管理两大类能力:
| 功能 | 作用 | 适合场景 |
|---|---|---|
| 任务(Tasks) | 保存"名称 + 提示词",按手动、单次、每天、每周、每月、每年或自定义 cron 计划自动运行 | 每日新闻摘要、周报生成、定时提醒类工作 |
| 对话循环(Loops) | 绑定某个对话,按固定间隔自动发起下一轮生成,支持每轮注入提示词 | 持续监控、逐步推进的长任务 |
官方文档对这套机制有完整说明:docs/zh/automation.md,自动化相关的核心源码集中在 automation/ 目录。
📋 创建第一个定时任务
从应用侧边导航进入 任务(Tasks) 页面,即可创建和管理任务。每个任务包含三部分:
- 名称与提示词:告诉 AI 每次运行时要做什么;
- 模型(可选):为单个任务指定模型,不填则使用应用默认模型;
- 排程(Schedule):支持 6 种模式——
| 排程类型 | 说明 | 底层 cron 形式(分 时 日 月 周) |
|---|---|---|
| 仅手动 | 只能点"立即运行" | 无 |
| 仅一次 | 指定未来的某个时间点 | 绝对时间戳(cron 无法表达年份) |
| 每天 | 每天固定时刻 | 分 时 * * * |
| 每周 | 勾选星期几 | 分 时 * * 0,1,2… |
| 每月 | 每月某日 | 分 时 日 * * |
| 每年 | 每年某月某日 | 分 时 日 月 * |
| 自定义(cron) | 标准五段式 cron 表达式 | 完全自定义 |
几点实用细节:
- 立即运行(Run now):不等排程,直接执行一次;
- 每次执行都会生成历史记录(成功 / 失败 / 已停止)和一段对应的对话,可随时回看结果;
- 关闭"按计划运行"后,任务仍可手动触发,不会被误删;
- 一次性排程的时间必须位于未来,否则无法保存。
排程类型到 cron 的映射逻辑在 TaskSchedule.kt 中定义;cron 表达式解析(支持 *、列表、区间、步长,遵循标准 Vixie-cron 规则)见 CronExpression.kt。
🔁 对话循环:让 AI 持续工作
循环(Loop)属于某一个对话,会按你设置的间隔自动发起下一轮生成:
- 间隔:最小 10 秒,最大 7 天;
- 最大轮数:1~100 轮(默认 10 轮),作为成本与安全护栏;
- 每轮提示词:可选注入,不填则默认发送
Continue.让 AI 继续; - 一个对话同一时间最多只能有一个活动循环。
界面中会实时显示 第 x/y 轮 与 下次 xx 后 的进度,随时可点击停止循环中断。循环的策略参数(间隔、轮数上限的校验)统一由 LoopPolicy.kt 管理,执行状态由 LoopManager.kt 维护。
💡 典型用法:让 AI 每 5 分钟检查一次网页更新并追加到对话中;或把一份长文档拆成多轮逐步总结,设置 15 轮上限避免"跑飞"。
⚙️ 设置中的自动化开关
在 设置 → 自动化 页面,有一个关键开关:访问任务与循环(Access Tasks and Loops),默认关闭。
- 开启后,模型可以通过工具创建、列出、删除任务,并启动或停止当前对话的循环;
- 权限在工具执行时会再次检查——即使模型之前已提出调用,只要你在执行前关闭了开关,调用就会被拦截,无法修改自动化状态。
⚠️ 安全提醒:仅在确实希望模型修改持久化日程时再开启。定时提示词可能在后台调用模型提供商和已启用的工具,会消耗 API 额度。
🔋 后台执行:保证任务准时跑
Android 的后台限制是定时任务最大的敌人,Agora 提供了对应设置:
- 精确执行(Exact Execution):为任务和循环申请精确闹钟。Android 12+ 上启用时会引导你授予"闹钟和提醒"权限;若拒绝或事后撤销,Agora 会自动回退到非精确调度,不会报错卡死。
- 电池优化:显示 Android 当前是否正在优化 Agora,点击可跳转系统设置。建议将 Agora 加入电池优化豁免,否则任务可能被延迟。
- 唤醒锁:可选,让每次任务或循环执行期间保持设备唤醒,代价是更耗电(默认由 WorkManager 保障即可)。
需要说明的是:精确闹钟 + 电池豁免能显著改善后台可靠性,但仍无法绕过网络断开、厂商后台限制等系统级因素。相关调度实现可见 AutomationScheduler.kt。
✅ 可靠性设计:不会"抢跑"也不会"双写"
Agora 的自动化与手动对话复用同一条生成流水线,几个设计值得点赞:
- 忙时不排队竞争:如果目标对话正在生成,本次自动化会直接返回"繁忙"结果,而不是创建第二个并发 Run;
- 编辑即失效:用户在任务排队期间编辑或删除任务,已入队的 Worker 会自动变成无害空操作;
- 常驻通知:自动化运行期间会显示通知,让你随时知道 AI 正在后台工作;
- 串行保护:同一任务的修改与执行被串行化,"立即运行"按钮连点也不会重复执行。
这些保护逻辑分散在 TaskManager.kt 与 TaskExecutionEngine.kt 中。
🎯 上手建议
- 先手动后定时:新建任务后先用"立即运行"验证提示词效果,再开启排程;
- 循环务必设轮数上限:默认 10 轮已经比较安全,不要盲目拉满 100 轮;
- 给任务指定便宜模型:定时跑摘要、整理类任务,可用小模型节省开支;
- 睡前/通勤前检查排程:自定义 cron 支持
分 时 日 月 周五段,例如0 9 * * 1表示每周一 9:00。
有了自动化任务与对话循环,Agora 不再只是"你问我答"的聊天框,而是一台可以按计划替你干活的手机端 AI 工作站。


