IM 定时提醒是一个跨平台定时提醒技能,用于在指定时间唤醒 Agent 执行操作并回复用户,保证准确的时间触发和消息送达。
用途:用户请求定时提醒(如“5 分钟后提醒我开会”)、周期性任务(如“每小时提醒我喝水”),或需要在指定时间触发 Agent 执行操作并回复用户。
主要能力:支持三种调度方式。一次性定时(at)在指定时间点触发一次,使用 atMs 毫秒时间戳;周期性定时(every)按固定间隔重复触发,使用 everyMs 毫秒间隔;Cron 表达式定时(cron)使用标准五位 cron 表达式,如 0 7 * * * 表示每天早上 7 点。
固定字段:enabled 必须为 true;sessionTarget 必须为 "isolated";payload.kind 为 "agentTurn";payload.deliver 必须为 true。动态字段:payload.channel 从运行时上下文获取当前频道类型(如 feishu);payload.to 为当前频道目标用户 ID,必填,缺失会导致消息无法送达。
使用方式:检测当前频道类型和用户 ID;将时间请求转换为时间戳或间隔毫秒数;构建完整 job 配置;调用 API 创建定时任务;确认成功后告知用户。频道和用户 ID 应始终从发起请求的原始上下文自动检测,不要硬编码。消息内容需包含让 Agent 生成响应的指令,避免纯文本消息。
限制与注意:sessionTarget 不可设为 main;deliver 和 enabled 不可缺失或为 false;payload.to 不可为空。具体 API 调用方式与安装命令资料未提供。