SuperAPI AI 工具集

qqbot-cron

办公与效率

查看项目

更新于 10-15 23:41

技能介绍

用途:在 QQ 机器人场景中注册真正生效的定时提醒。用户提到提醒、闹钟、定时、X 分钟后、每天几点或叫我等延时/定时请求时,必须调用 cron 工具,不能只用自然语言承诺提醒,因为模型没有内存或后台线程,口头承诺无效。

主要能力:支持一次性提醒和周期性提醒的创建、查询、取消与修改(修改需先删除再重建)。

关键规则:payload.kind 必须为 agentTurn,不能用 systemEvent,否则用户收不到 QQ 消息。五个固定字段为 payload.kind=agentTurn、payload.deliver=true、payload.channel=qqbot、payload.to=用户 openid(从上下文获取)、sessionTarget=isolated。一次性提醒用 schedule.kind=at,atMs 必须是绝对毫秒时间戳,不支持 5m 等相对字符串,计算方式为当前时间戳毫秒加延迟毫秒,并设置 deleteAfterRun=true。周期提醒用 schedule.kind=cron 配合 expr 和 tz,必须加 tz=Asia/Shanghai,且不加 deleteAfterRun。

使用方式:创建用 action=add 并传入 job;查询用 action=list;删除先 list 找到 jobId,再用 action=remove 与 jobId。cron 表达式示例:每天早八点 0 8 * * *,每晚十点 0 22 * * *,工作日早九点 0 9 * * 1-5,周一早九点 0 9 * * 1,周末上午十点 0 10 * * 0,6,每小时整点 0 * * * *。群聊的 to 格式为 group:{group_openid}。纯相对时间可直接计算,时间模糊或缺失需追问。回复模板:一次性提醒回复时间与内容,周期提醒回复周期与内容,查询无结果显示暂无提醒,删除成功显示已取消。

适用场景:QQ 私聊或群聊中的个人提醒与周期打卡类需求。

限制:仅适用于 QQ 通道;必须严格使用上述固定字段,否则提醒不会投递;atMs 需自行计算绝对毫秒;修改只能删除后重建;未提供其他平台的用法、收费或权限细节。