// 08

定时任务 (Scheduler)

概述

定时任务页面让你创建和管理自动执行的计划任务。AI Agent 会按你设定的时间表自动运行任务——生成日报、扫描洞察、发送待办提醒,或执行任意自定义 Prompt。

路由:/scheduler

可调度的内容

每个任务可以执行以下两类内容之一:

  • 预定义动作: 从后端注册表动态拉取的内置工具,例如 generate_reportcreate_pptxsend_email
  • 自定义 Prompt: 任意自然语言提示词,由 Agent 在触发时执行

三种触发类型

  • once: 在指定时间执行一次
  • interval: 按固定时间间隔重复执行(如每 3 小时)
  • cron: 按 cron 表达式执行(如 0 9 * * 1-5 每个工作日早上 9 点)

顶部统计与倒计时

页面顶部展示四张统计卡:

  • 总任务: 所有定时任务数量
  • 活跃: 当前正在运行的任务
  • 暂停: 已暂停的任务
  • 错误: 最近一次执行失败的任务

下方有一条下次执行倒计时横幅,显示即将到来的下一次触发。

任务卡片

每个任务以卡片形式展示,包含:

  • 名称状态徽标(运行中 / 已暂停 / 错误)
  • 调度类型:once / interval / cron
  • 动作:预定义动作名 或 自定义 Prompt 摘要
  • 上次运行 / 下次运行 时间
  • 运行次数 计数
  • 操作按钮
    • Play / Pause — 启用 / 暂停任务
    • Run Now — 立即执行一次,不影响计划
    • Edit — 修改名称、调度、动作、参数
    • Delete — 删除任务(需二次确认)
    • History — 展开历史时间线,查看每次执行的状态与结果摘要

创建任务

点击右上角的「新建任务」按钮,按提示填写:

  1. 名称描述
  2. 动作类型:预定义动作(下拉选择) 或 自定义 Prompt(自由输入)
  3. 触发类型:once / interval / cron,并填写相应时间
  4. (可选)通知渠道重试次数 等高级选项

对话方式管理

你也可以在助手中用自然语言管理定时任务:

  • 创建:「每天早上 9 点生成日报」
  • 查看:「我有哪些定时任务?」
  • 暂停 / 删除:「暂停日报任务」 / 「删掉那个每 3 小时执行的任务」