SuperAPI AI 工具集

cron

通用与其它

查看项目

更新于 10-15 23:59

技能介绍

用途:cron 用于为智能体创建和管理定时任务(cron 作业),在指定时间触发并发送消息。任务创建后立即生效,无需重启。

主要能力与用法:通过 lettabot-cron 命令管理任务。常用命令包括:lettabot-cron list 列出全部任务;lettabot-cron create [options] 创建任务;lettabot-cron delete ID 删除任务;lettabot-cron enable ID 启用任务;lettabot-cron disable ID 禁用任务。

创建任务支持参数:-n/--name 任务名称(必填);-s/--schedule cron 表达式(必填);-m/--message 触发时发送给智能体的提示(必填);-d/--deliver 自动投递响应到频道,格式为 channel:chatId;--disabled 以禁用状态创建。

运行模式有两种:静默模式下不指定 --deliver,智能体收到消息并可执行动作,但响应不会自动发送到聊天,需智能体自行使用 lettabot-message send 发送;投递模式下指定 --deliver channel:chatId,响应在执行后自动投递到对应频道。

调度语法采用标准五段式 cron:分、时、日、月、星期(0-6,周日为0)。常见示例:0 8 * * * 每日8点;0 9 * * 1-5 工作日9点;0 */2 * * * 每2小时;30 17 * * 5 每周五17:30;0 0 1 * * 每月1日零点。触发时智能体收到的消息含任务ID、名称、提示内容和当前时间。

任务持久化于 cron-jobs.json,日志写入 cron-log.jsonl,可用 list 查看下次运行时间和上次状态。

限制:不指定 --deliver 时响应不会自动送达用户,需智能体主动发送;其余平台范围等细节资料中暂未提供。