SuperAPI AI 工具集

cron

办公与效率

查看项目

更新于 10-15 19:52

技能介绍

用途:仅在需要「未来某时执行」或「定期重复执行」时使用,例如用户要求每天/每周/每小时执行、指定时间提醒,或需要长期周期性的通知、检查与报告。若任务只需立刻执行一次、只是当前会话中的普通回复,或未给出执行时间与目标渠道/用户/会话,则不应使用。

主要能力:通过 qwenpaw cron 管理定时任务,包含列出(list)、查看详情(get)、查看状态(state)、创建(create)、暂停(pause)、恢复(resume)、删除(delete)、立即运行一次(run)。创建支持两种类型:text(按计划发送固定消息)与 agent(按计划向智能体提问并将其回复发送到目标渠道)。Cron 表达式示例:0 9 * * * 每天 9:00;0 /2 * * * 每 2 小时;30 8 * * 1-5 工作日 8:30;0 0 * * 0 每周日零点;/15 * * * * 每 15 分钟。

使用方式:所有命令必须显式包含 --agent-id <agent_id>,其值见系统提示的 Agent Identity 部分;不要依赖默认 agent,否则任务可能创建到默认工作区。创建前需确认 --type、--name、--cron、--channel、--target-user、--target-session、--text、--agent-id,缺失则先向用户确认。创建后可结合 list/state/pause/resume/delete 管理。也支持从 JSON 创建:qwenpaw cron create --agent-id <agent_id> -f job_spec.json。修改、暂停或删除前应先运行 qwenpaw cron list --agent-id <agent_id> 找到正确 job_id;排查问题可用 qwenpaw cron state <job_id> --agent-id <agent_id>;帮助信息可用 qwenpaw cron -h 及各子命令 -h。向用户展示命令时应提供完整可复制版本。

适用场景:周期性提醒、定时问候、定期检查待办、长期报告等。限制:不适用于一次性立即执行任务;目标渠道/用户/会话不明确时不创建;除 -h 帮助外所有命令必须带 --agent-id。