Skip to content

定时任务

定时任务会保存一条完整指令,并在未来通过独立的设备智能体会话执行。先在对话中创建任务,再到 定时任务 页面查看详情、暂停或恢复后续执行、修改指令,以及检查每次执行结果。

创建任务

进入设备智能体工作区。如果任务需要操作指定设备,先选中目标设备,再说明任务内容和执行时间。设备智能体支持一次性、固定间隔和 cron 计划,创建成功后会返回下次执行时间。

任务类型示例
延迟执行1 分钟后把当前温控器的目标温度设为 24 度。
固定间隔每 5 分钟检查一次当前温度,超过 30 度就把目标温度设为 24 度。
每日执行每天早上 9 点把当前温控器切换到节能模式。

指令必须独立、完整,因为任务会在单独的会话中执行,不能依赖当前对话里没有写入指令的上下文。任务会保存调度规则、时区、设备智能体和设备范围。

固定间隔最短为 60 秒。绝对时间未指定时区时,使用创建任务时的 Gateway 系统时区。

定时任务对话

管理任务

打开 定时任务进行中包含待执行、已暂停和正在执行的任务;已完成包含已经结束的一次性任务。选择任务后,可以查看指令、调度规则、时区、设备范围、状态、上次与下次执行时间、来源会话和最近错误。页面顶部的任务 ID 可用于关联日志。

定时任务页面

操作结果
启用或暂停暂停后不再开始新的运行,已经开始的运行会继续。恢复已过期任务时,一次性任务会进入待执行状态,周期任务会重新计算下次时间。
编辑指令只修改后续运行使用的指令,不改变调度规则、时区和设备范围。正在运行的任务仍使用原指令。
打开对话返回创建任务的对话;来源对话仍可定位时才会显示。
取消停止后续调度,已经开始的运行会继续。

已完成任务只能查看。修改调度规则、时区或设备范围时,需要取消原任务并重新创建。也可以在对话中管理任务;存在相似任务时请使用任务 ID 指定目标。

查看执行历史

选择任务并点击 执行历史,即可查看每次运行的开始与完成时间、状态、耗时、结果或错误、执行记录 ID 和独立会话 ID。可以展开记录查看完整结果。

定时任务执行历史

需要进一步排查时,点击 查看日志 打开带任务 ID 的日志。执行历史显示成功,只表示设备智能体完成了保存的指令;涉及设备操作时,还应检查设备当前状态、设备端日志或 MQTT 消息。

运行和重启边界

  • 任务、状态和执行历史会持久化。Gateway 重启后恢复已启用任务,已暂停任务仍保持暂停。
  • Gateway 停止期间不会执行任务。启动后,已过期的启用任务最多补执行一次,周期任务不会重放所有错过的时间点。
  • Gateway 在运行过程中停止时,本次执行会记为失败。一次性任务不会自动重试,周期任务会继续安排后续执行。
  • 每次运行都会使用任务保存的设备智能体和设备范围;目标设备及依赖的外部服务必须在执行时可用。