SuperAPI AI 工具集

cron

通用与其它

查看项目

更新于 10-15 22:13

技能介绍

用途:cron 工具用于安排提醒或周期性任务,可让消息直接发送给用户,也可让智能体执行任务描述并返回结果。

主要能力:支持三种模式——提醒(消息直接发给用户)、任务(消息为任务描述,智能体每次执行并发送结果)、一次性(在指定时间运行一次后自动删除)。触发方式包括固定间隔(every_seconds)、cron 表达式(cron_expr)和指定时间(at,ISO 日期时间字符串)。可用 tz 参数配合 cron_expr 指定 IANA 时区;不指定 tz 时使用服务器本地时区。

使用方式:添加任务用 cron(action="add", message="...", every_seconds=1200) 或 cron(action="add", message="...", cron_expr="0 9 * * 1-5", tz="America/Vancouver"),一次性任务用 at 参数。查看和删除分别用 cron(action="list") 与 cron(action="remove", job_id="abc123")。常见时间表达可映射为参数,如每 20 分钟对应 every_seconds: 1200,每天 8 点对应 cron_expr: "0 8 * * *",工作日 17 点对应 cron_expr: "0 17 * * 1-5"。

适用场景:定时提醒、周期性检查或报告类任务、按工作日或指定时区触发的例行安排。

限制:资料未提供任务数量上限、持久化方式、失败重试、权限控制及具体平台支持等细节,暂未提供。