参考
调度、时区与结果位置
查阅 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/Shanghai、UTC 等时区,初始时区来自当前客户端环境。保存前明确选定任务使用的时区,再核对下次运行时间。
同一个 0 9 * * * 在 Asia/Shanghai 和 UTC 下不是同一时刻。跨地区协作时,把报告覆盖日期的时区也写进指令,避免调度按一种时区、材料按另一种时区截取。
有效期决定这项计划何时结束,不是单次运行的超时时间。到期后仍应查看最后一条运行记录,判断到期前开始的任务状态。
权限副本
选择 复制当前权限 时,有执行会话就复制其有效模式,否则复制 Agent 模式,同时复制 Agent 的工具允许和禁止规则。创建之后任务持有独立副本。
因此,后来修改 Agent 权限不会自动重写旧任务。长期任务需要新的能力时,应检查任务自身的权限与审批,不要只改全局默认。
运行状态与投递状态
| 运行状态 | 说明 | 接下来做什么 |
|---|---|---|
| 等待或排队 | 还未进入实际执行或排在会话队列中 | 检查上下文和队列 |
| 运行 | 正在处理任务 | 查看是否等待审批或信息 |
| 成功 | 本次执行完成 | 检查产物与投递状态 |
| 失败 | 本次执行失败 | 阅读错误和已完成部分 |
| 跳过 | 本次没有执行 | 检查记录原因及调度策略 |
| 取消 | 本次执行被取消 | 核对已发生的操作 |
投递状态另行显示。无需投递 在未设置额外发送时是正常结果;投递失败 不表示生成文件也失败;投递结果待确认 需要先检查接收位置。
执行已成功而投递失败时,优先重试投递。重新运行整个任务可能再次写文件或产生外部操作。
停用、删除与离线恢复
停用阻止后续计划触发,不撤销已执行动作。删除中的任务需要等待收尾,出现删除待处理时按页面处理,不要把删除当作立即取消所有运行的替代方式。
宿主离线期间无法正常执行。恢复后的错过任务处理受部署调度策略影响,不能假定每个时间点都会补跑。查看运行记录和下次运行时间,再决定是否手动执行一次。
按步骤创建一项任务见定时任务与主动跟进。