定时任务(Scheduled Task)绑定一个智能体并配置触发方式,支持定时或手动触发运行,适合每日汇总、定期巡检等无人值守任务。
定时任务(Scheduled Task,API 中的资源名为 Deployment)绑定一个智能体并配置触发方式:定时触发按 cron 表达式自动执行,手动触发在点击「运行」时执行。每次触发创建一个会话,向智能体发送创建时固定的初始消息,执行过程与结果记录为一条运行记录(Run)。
控制台侧边栏的「部署」页即定时任务的管理入口。
适合无人值守的周期性任务:每日数据汇总、定期巡检、按小时同步。需要多轮交互的任务请使用会话。
进入控制台「部署」页,点击「创建部署」,配置绑定的智能体、运行环境、初始消息与触发方式等。触发方式支持手动触发或定时调度;定时调度使用标准 Cron 表达式(分 时 日 月 周)并指定执行时区,例如
手动任务在列表或详情页点击「运行」触发;定时任务按表达式自动触发。每次触发产生一条运行记录,进入任务详情页的运行历史查看:
创建一个工作日 9 点(Asia/Shanghai)定时执行的任务。完整参数与响应字段见 创建 Deployment API:
在控制台创建
进入控制台「部署」页,点击「创建部署」,配置绑定的智能体、运行环境、初始消息与触发方式等。触发方式支持手动触发或定时调度;定时调度使用标准 Cron 表达式(分 时 日 月 周)并指定执行时区,例如 (GMT+08:00) Asia/Shanghai。
触发与运行记录
手动任务在列表或详情页点击「运行」触发;定时任务按表达式自动触发。每次触发产生一条运行记录,进入任务详情页的运行历史查看:
- 运行 ID:单次执行的标识,
drun_前缀。 - 触发来源:
manual或scheduled。 - 状态:
running、succeeded、failed。 - 会话:本次运行创建的会话 ID,可按会话方式查询事件历史与输出。
- 开始 / 结束时间。
暂停与归档
- 暂停:停止定时触发,保留配置;恢复后继续按原表达式执行。
- 归档:归档后不可触发,操作幂等。
通过 API 管理
创建一个工作日 9 点(Asia/Shanghai)定时执行的任务。完整参数与响应字段见 创建 Deployment API:
agent.version 锁定智能体版本,不传则使用最新版本。更新任务时 schedule 传 null 可清除定时触发,改回手动。
常用操作:
- 触发一次运行:触发 Deployment Run
- 暂停 / 恢复:暂停、恢复
- 查看运行记录:列出 Deployment Runs