参考

调度、时区与结果位置

查阅 Cron、执行上下文和送达重试的区别。

一项任务包含四组设置

定时任务同时确定执行内容、执行上下文、触发时间和结果位置。先决定由哪个 Agent 处理什么材料,再设置时间。否则容易出现“任务按时完成,但读错材料或把结果放错会话”的情况。

任务定义和运行记录分别查看。定义描述以后怎样运行,记录说明某一次实际上发生了什么。

当前新建任务的运行上下文

选项历史如何使用适合什么工作
复用已有会话使用指定会话的历史在已讨论的项目中继续处理
独立运行每次使用独立上下文,不积累旧轮内容从文件重新生成日报或检查报告

当前新建界面提供这两种选择。编辑使用旧配置的任务时,还可能看到“使用主会话”或“使用专用长期会话”。前者接入 Agent 主会话,后者持续复用一段专用会话;它们不是当前新建表单中的常规选项。

Room 任务还要选定 Room 会话和执行成员。不能只选群名而不指定实际负责执行的成员。

独立上下文不代表文件系统隔离。多次执行仍可能读写同一个输出文件。需要保留历史报告时,在任务要求中指定按日期命名。

结果位置与执行位置分开

不额外发送 将结果留在运行记录,不额外发消息。发送到指定位置 可以把结果交给有效的 Agent、Room 或 IM 会话。

接收目标需要确认
Agent 会话接收 Agent 与会话存在
Room接收 Room、会话与回复成员有效
IM 会话外部会话仍有有效绑定,通道可发送

使用主会话时不支持额外结果回传,不能同时选择发送到另一个位置。Room 的执行成员与回复成员承担不同作用,分别核对。

调度方式

方式设置内容示例
单次未来的日期和时间明天下午检查一次材料
每天时间与执行日工作日 9 时整理日报
每月日期与时间每月 1 日生成汇总
间隔正数及秒、分钟或小时单位每隔 30 分钟检查一次
自定义 Cron标准五段表达式每周五 17 时生成周报

每天模式可以选择执行日,全选才是每天。单次时间必须在未来;有效期填写后也必须是未来时间。每月选择 31 日时,没有该日期的月份不会执行。

Cron 五段怎样读

分钟  小时  日  月  星期
0     9     *   *   1-5
表达式含义
0 9 * * *每天 9 时
0 9 * * 1-5周一至周五 9 时
0 17 * * 5每周五 17 时
0 10 1 * *每月 1 日 10 时

输入框使用五段格式,不要在开头再加秒字段。间隔任务与固定钟点不同,要求“每天 9 时”时使用每天或 Cron,不用每隔 24 小时代替。

时区和有效期

表单可以选择 Asia/ShanghaiUTC 等时区,初始时区来自当前客户端环境。保存前明确选定任务使用的时区,再核对下次运行时间。

同一个 0 9 * * *Asia/ShanghaiUTC 下不是同一时刻。跨地区协作时,把报告覆盖日期的时区也写进指令,避免调度按一种时区、材料按另一种时区截取。

有效期决定这项计划何时结束,不是单次运行的超时时间。到期后仍应查看最后一条运行记录,判断到期前开始的任务状态。

权限副本

选择 复制当前权限 时,有执行会话就复制其有效模式,否则复制 Agent 模式,同时复制 Agent 的工具允许和禁止规则。创建之后任务持有独立副本。

因此,后来修改 Agent 权限不会自动重写旧任务。长期任务需要新的能力时,应检查任务自身的权限与审批,不要只改全局默认。

运行状态与投递状态

任务触发、执行和结果投递的流程示意

运行状态说明接下来做什么
等待或排队还未进入实际执行或排在会话队列中检查上下文和队列
运行正在处理任务查看是否等待审批或信息
成功本次执行完成检查产物与投递状态
失败本次执行失败阅读错误和已完成部分
跳过本次没有执行检查记录原因及调度策略
取消本次执行被取消核对已发生的操作

投递状态另行显示。无需投递 在未设置额外发送时是正常结果;投递失败 不表示生成文件也失败;投递结果待确认 需要先检查接收位置。

执行已成功而投递失败时,优先重试投递。重新运行整个任务可能再次写文件或产生外部操作。

停用、删除与离线恢复

停用阻止后续计划触发,不撤销已执行动作。删除中的任务需要等待收尾,出现删除待处理时按页面处理,不要把删除当作立即取消所有运行的替代方式。

宿主离线期间无法正常执行。恢复后的错过任务处理受部署调度策略影响,不能假定每个时间点都会补跑。查看运行记录和下次运行时间,再决定是否手动执行一次。

按步骤创建一项任务见定时任务与主动跟进