HermesAgent定时任务需用标准Cron表达式配置:六字段(秒分时日月周),支持范围、逗号、斜杠语法,禁用L、英文缩写及全通配符,须校验版本≥v2.4.0并配合脚本逻辑规避限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要在HermesAgent中配置定时任务,必须通过标准Cron表达式定义执行时间规则。Cron表达式由6个或7个字段组成,分别对应秒、分、时、日、月、周、年(可选),各字段间以空格分隔。以下是几种常用且有效的写法示例及对应操作步骤:
一、基础六字段Cron表达式格式
HermesAgent默认支持6字段Cron格式(秒 分 时 日 月 周),不包含年字段。该格式兼容Quartz规范,适用于绝大多数周期性调度场景。
1、确认HermesAgent版本不低于v2.4.0,该版本起正式启用6字段解析器。
2、在任务配置界面的“执行计划”输入框中,直接填写形如 0 30 9 * * ? 的表达式,表示每天上午9:30执行。
3、避免使用 * * * * * * 这类全通配符,可能导致任务每秒触发一次,引发资源过载。
二、指定星期几的精确匹配写法
当需限定任务仅在工作日(周一至周五)运行时,应使用周字段的数值范围而非英文缩写,确保HermesAgent解析一致性。
1、使用数字1–7表示周一至周日,其中 1 代表周一,7 代表周日。
2、填写表达式 0 0 10 ? * 2-6,表示每周二至周六上午10:00执行。
3、禁用 MON-FRI 或 MON,WED,FRI 等非数字形式,HermesAgent不识别此类字符串。
三、每月特定日期组合触发方式
若任务需在每月多个固定日期(如每月5日和20日)且固定时间运行,需利用日字段的逗号分隔语法,而非重复创建多个任务。
1、在日字段中填入多个日期值,用英文逗号连接,中间不加空格。
CA.LA
第一款时尚产品在线设计平台,服装设计系统
下载
2、输入表达式 0 15 14 5,20 * ?,表示每月5日与20日下午2:15执行。
3、不可写作 0 15 14 5 20 * ?,该写法会被解析为“每月5日、20时”,导致逻辑错误。
四、排除月末最后一天的规避写法
HermesAgent不支持L(Last)字符用于日字段,直接使用L会导致解析失败并跳过调度。需改用日期范围+条件判断替代。
1、将月末需求转化为固定日期区间,例如每月25日至31日之间某时刻执行。
2、设置表达式 0 0 2 ? * 25-31,并在任务脚本内增加日期校验逻辑,仅当实际日期为当月最后一天时才执行主体逻辑。
3、严禁输入 0 0 2 L * ?,该表达式在HermesAgent中视为非法格式,保存时会报错。
五、跨小时段高频触发的安全写法
对于需每15分钟执行一次的任务,必须控制最小间隔,防止因执行耗时叠加引发并发冲突。
1、使用斜杠(/)表示增量,格式为“起始值/步长”,如分字段填 0/15 表示从第0分钟起,每15分钟一次。
2、完整表达式为 0 0/15 * * * ?,即每小时的0、15、30、45分执行。
3、禁止使用 0 * * * * ?(每分钟执行),除非已明确评估任务执行时长远小于60秒且无状态竞争风险。
