Cron

定时任务管理

何时使用

只有在需要未来某个时间自动执行，或按周期重复执行时使用本技能。

应该使用

• 用户要求"每天 / 每周 / 每小时"执行某件事
• 用户要求"明天 9 点 / 下周一 / 某个时间"自动提醒或执行
• 需要长期周期性通知、检查、汇报

不应使用

• 只是现在立即执行一次
• 只是当前会话中的正常回复
• 用户没有明确执行时间或周期

工具速查

工作流程

第一步：确认必要信息

创建前必须确认以下信息，缺一不可：

• 任务名称（name）
• 执行周期（cronExpression，5 段 cron 表达式）
• 触发消息（triggerMessage，任务触发时 Agent 收到的提示词）
• 时区（timezone，可选，默认 Asia/Shanghai）

信息不全时先追问用户，不要用占位符创建任务。

第二步：创建任务

create_cron_job(
  name="每日早报",
  cronExpression="0 9 * * *",
  triggerMessage="请获取今日财经新闻并发送摘要给用户",
  timezone="Asia/Shanghai"
)

第三步：管理任务

查看所有任务：

list_cron_jobs()

暂停（从返回的任务列表中获取 jobId）：

toggle_cron_job(jobId=123, enabled=false)

恢复：

toggle_cron_job(jobId=123, enabled=true)

删除：

delete_cron_job(jobId=123)

Cron 表达式参考（5 段格式）

格式：分 时 日 月 周
0 9 * * *        每天 09:00
0 */2 * * *      每 2 小时整点
30 8 * * 1-5     工作日 08:30
0 0 * * 0        每周日零点
*/15 * * * *     每 15 分钟
0 9,18 * * *     每天 09:00 和 18:00

常见错误

• 缺少信息就创建：必须先确认周期、名称和触发消息
• 只是立即执行一次：不需要创建 cron，直接执行即可
• 时区混淆：默认 Asia/Shanghai；若用户在其他时区，明确指定

安全须知

• triggerMessage 是 Agent 触发时收到的提示词，不是发给用户的消息
• 避免创建执行频率极高（< 5 分钟）的任务，除非用户明确需要