定时任务
定时任务会保存一条完整指令,并在未来通过独立的设备智能体会话执行。先在对话中创建任务,再到 定时任务 页面查看详情、暂停或恢复后续执行、修改指令,以及检查每次执行结果。
创建任务
进入设备智能体工作区。如果任务需要操作指定设备,先选中目标设备,再说明任务内容和执行时间。设备智能体支持一次性、固定间隔和 cron 计划,创建成功后会返回下次执行时间。
| 任务类型 | 示例 |
|---|---|
| 延迟执行 | 1 分钟后把当前温控器的目标温度设为 24 度。 |
| 固定间隔 | 每 5 分钟检查一次当前温度,超过 30 度就把目标温度设为 24 度。 |
| 每日执行 | 每天早上 9 点把当前温控器切换到节能模式。 |
指令必须独立、完整,因为任务会在单独的会话中执行,不能依赖当前对话里没有写入指令的上下文。任务会保存调度规则、时区、设备智能体和设备范围。
固定间隔最短为 60 秒。绝对时间未指定时区时,使用创建任务时的 Gateway 系统时区。

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

| 操作 | 结果 |
|---|---|
| 启用或暂停 | 暂停后不再开始新的运行,已经开始的运行会继续。恢复已过期任务时,一次性任务会进入待执行状态,周期任务会重新计算下次时间。 |
| 编辑指令 | 只修改后续运行使用的指令,不改变调度规则、时区和设备范围。正在运行的任务仍使用原指令。 |
| 打开对话 | 返回创建任务的对话;来源对话仍可定位时才会显示。 |
| 取消 | 停止后续调度,已经开始的运行会继续。 |
已完成任务只能查看。修改调度规则、时区或设备范围时,需要取消原任务并重新创建。也可以在对话中管理任务;存在相似任务时请使用任务 ID 指定目标。
查看执行历史
选择任务并点击 执行历史,即可查看每次运行的开始与完成时间、状态、耗时、结果或错误、执行记录 ID 和独立会话 ID。可以展开记录查看完整结果。

需要进一步排查时,点击 查看日志 打开带任务 ID 的日志。执行历史显示成功,只表示设备智能体完成了保存的指令;涉及设备操作时,还应检查设备当前状态、设备端日志或 MQTT 消息。
运行和重启边界
- 任务、状态和执行历史会持久化。Gateway 重启后恢复已启用任务,已暂停任务仍保持暂停。
- Gateway 停止期间不会执行任务。启动后,已过期的启用任务最多补执行一次,周期任务不会重放所有错过的时间点。
- Gateway 在运行过程中停止时,本次执行会记为失败。一次性任务不会自动重试,周期任务会继续安排后续执行。
- 每次运行都会使用任务保存的设备智能体和设备范围;目标设备及依赖的外部服务必须在执行时可用。