计划任务
面向 AI Agent:本页的 Markdown 版本位于 https://ankole.agentbull.com/zh-Hans-CN/docs/schedules/index.md,全站文档索引位于 https://ankole.agentbull.com/zh-Hans-CN/llms.txt。
Ankole 提供两类互补的定时调度工具:
- Cron:按周期反复执行同一项工作,例如每天早上生成工作简报、每周汇总项目进度,或每隔 30 分钟巡检一次服务状态。
- Checkback:仅在指定时刻唤醒当前会话一次,适合让 Agent 暂停等待一段时间后再回来跟进后续进展。
Cron
Cron 用于管理需要周期性重复运行的任务,既支持按固定日历时刻触发,也支持从某一基准时刻起按固定时间间隔循环运行。
直接让 Agent 创建
日常使用时无需打开 Console 配置界面——直接在希望接收结果的聊天会话中告诉 Agent 要做什么、何时执行以及采用哪个时区,Agent 便会自动创建好计划任务,并在每次触发后将结果发回当前会话。
请创建一个计划任务:每个工作日上午 9 点整理昨天的工作进展、
当前阻塞和今天要跟进的事项,并把结果发到当前会话。
时区使用 Asia/Shanghai。创建后先立即运行一次,
让我确认内容和投递位置。
高级:从控制台创建计划任务
手动在控制台创建计划任务前,请先在目标聊天窗口中与该 Agent 正常对话一次,确认对应的信号路由规则已能顺畅收发消息。
- 打开 Console 的计划任务页面。
- 选择目标 Agent 及管理该计划任务的 Session;若下拉列表中未显示目标 Session,可直接输入其 Session ID。
- 切换到 Cron 标签页,点击新建计划任务。
- 选择用于回传结果的路由规则,并填写便于辨识的任务名称。
- 填写包含必要背景信息的任务指令,选择调度类型并设置执行时间。
- 选择投递会话,或填写 Ankole 的 Conversation ID;投递到外部聊天的固定话题或线程时,再填写外部平台的线程 ID。
- 保存后点击立即运行先行实测一次,确认任务内容与消息投递位置均准确无误后,再交由系统按计划自动调度。
选择时间规则
Cron(表达式) 适合具有明确日历语义的排期(例如每个工作日上午 9 点),支持标准的 5 字段表达式或带秒位的 6 字段表达式。
时区请务必填写标准 IANA 时区名称(如 Asia/Shanghai),切勿使用 UTC+8 这类容易引起夏令时或解析歧义的偏移量写法。
0 9 * * 1-5
上例代表每周一至周五上午 9 点整触发。系统严格按照该计划任务自身配置的时区换算触发时刻,不受操作者浏览器时区或 Worker 宿主机系统时区的影响。
间隔(周期) 则适合“每隔固定时长巡检一次”的场景(如每 30 分钟检查一次),填写间隔时长并选择秒、分钟、小时或天,由锚点时间确定周期的起算点。无特定日历时刻要求的轮询任务更适合采用这种方式。
任务内容和投递位置
以 Agent 为处理目标的 Cron 规则在独立 Session 中执行,不会继承创建它的会话所用 Session 的历史。任务指令应自包含,写清每次执行需要的背景信息与具体动作。Agent 仍会加载角色设定和长期准则,无需把 AGENTS.md 或文体指令重复写进任务。
选择投递会话,或填写 Ankole 的 Conversation ID。投递到外部聊天时,还需选择对应的路由规则;仅在每次都需要回复到同一话题或线程时,填写外部平台的线程 ID。
首次配置完毕后,请务必点击立即运行验证一遍,以免等到预定时刻才发现消息投递到了错误的位置。
暂停、恢复和删除
- 暂停:保留全部配置但停止按时触发,适合节假日静默或临时停用。
- 恢复:重新启用任务,并基于当前时间重算下一次触发时刻。
- 立即运行:立刻额外触发一次执行,不影响原有的周期排程。
- 删除:彻底移除该计划任务;若后续仍可能重新启用,建议优先选择“暂停”。
点开任意计划任务即可查看最近的历史运行记录。排查异常时,建议先看任务是否按时触发,再顺藤摸瓜定位究竟是时间规则、Agent 推理执行还是消息投递环节出了问题。
Checkback
Checkback 是 Agent 在处理工作途中为自己预约的一次性定时回访,例如“30 分钟后再回来确认本次部署是否成功”。到期后,系统默认唤醒原会话,让 Agent 带着之前的上下文无缝继续处理。
Agent 在有明确的后续检查事项时预约一次 Checkback,控制面在到期时投递一次唤醒事件。等待期间无需反复调用模型检查是否有事可做。
使用时,只需在对话中自然说明多久之后回来、检查什么内容,以及遇到哪些情况需要发消息通知你。例如:
30 分钟后回来检查这次部署是否完成。
如果失败、遇到阻塞或状态发生变化,请告诉我;没有变化就保持静默。
打开 Console 的 Checkbacks 标签页,可以查看当前会话下所有尚未到期的待触发回访,核对预计触发时间、预约原因与投递规则,或随时手动取消不再需要的提醒。
Applet 任务定时
确定性工作可发布为 Applet Action,再在 Applet「自动化」面板创建任务,并直接为任务添加定时。此路径不要求 Agent 会话、任务提示词或聊天目标。可配置 Cron、固定间隔或指定时间,选择时区,并填写 Action 需要的 JSON 载荷。
面板支持修改、暂停、恢复、立即运行和删除定时,并显示触发历史及关联的运行记录,包括失败和输入合并状态。Action 通过 ctx.signal.data 读取事件,通过 ctx.state 保存进度。个人定时遵循任务所有者的权限,团队定时遵循页面编辑权限。
Agent 创建的 Cron 和 Checkback 也可通过消费者绑定投递给 Applet 任务。每次投递都需要判断或对话时,保留 Agent 消费者。参阅自动化任务和Worker CLI 能力。
常见问题
- 到期未触发:确认任务处于启用状态,并核查 Cron 表达式、所选时区及页面显示的“下次触发”时间。
- 已触发但聊天窗口未收到消息:先查看任务运行记录,再依次检查信号路由规则、目标投递渠道与对应 Agent 是否均处于正常可用状态。
- 触发时间固定偏差几个小时:请改用准确的 IANA 时区名称,并核查实例的全局时区配置。
- 消息发到了错误的窗口或话题:修正投递会话或外部平台线程 ID,随后点击立即运行重新验证。
- 预约的 Checkback 没有回访:前往 Console 的 Checkbacks 标签页确认该提醒未被取消,并核对到期时间与原会话的投递规则。
更多复杂故障的排查与恢复步骤,请参阅 计划任务故障排查。