定时任务

Documentation Index

Fetch the complete documentation index at: https://docs.codebanana.com/llms.txt

Use this file to discover all available pages before exploring further.

​

什么是定时任务

定时任务是一种 在合适时间触发 Agent 执行任务 的机制，支持以下方式：

• 在指定时间执行（例如每天早上 7 点）
• 按固定间隔执行（例如每 30 分钟）
• 在特定事件发生时执行（例如文件变更）

这使 Agent 即使在您未主动与其交互时，也能够 异步运行。

​

定时任务类型

主要分为两类：

​

Heartbeat（基于间隔）

按固定时间间隔重复运行任务。

• 配置时间间隔（例如每 30 分钟）
• 执行 HEARTBEAT.md 中定义的全部任务
• 适用于：
  • 周期性检查
  • 监控类工作流
  • 批处理任务

​

Scheduled Tasks（基于时间 / 事件）

在指定时间或触发条件下运行任务。

• 基于时间的方式：
  • Daily、Weekly、Monthly
  • One-time execution
  • Custom intervals
• 基于事件的方式（File Watch）：
  • 当文件被新增、修改或删除时触发
  • 例如：当文件被删除时发送通知

​

如何选择

1. 这是一次性任务或提醒吗？
   • 是 → 使用 Scheduled Task
   • 否 → 继续
2. 任务是否需要在精确时间运行？
   • 是 → 使用 Scheduled Task
   • 否 → 继续
3. 此任务能否与其他周期性检查统一处理？
   • 是 → 使用 Heartbeat（将其添加到 HEARTBEAT.md）
   • 否 → 使用 Scheduled Task
4. 此任务是否由文件变化或其他事件触发？
   • 是 → 使用 Scheduled Task（File Watch）
   • 否 → 按以上规则选择

​

配置方式

Heartbeat

1. 通过打开 右侧面板中的开关 启用 Heartbeat
2. 设置 执行间隔（例如每 10 分钟、每 30 分钟等）
3. 系统会在每个间隔到达时，自动执行 HEARTBEAT.md 中定义的所有任务

任务管理方式：

• 点击 HEARTBEAT.md 旁的 Edit 修改任务内容
• 点击 Reset 恢复默认配置

Scheduled Task

1. 点击 Create New Task 创建任务
2. 定义 Trigger Conditions，即任务的触发时机：
   • Scheduled（基于时间） 可选择：
     • Daily — 每天在指定时间执行
     • Weekly — 每周在指定日期和时间执行
     • Monthly — 每月在指定日期和时间执行
     • Once — 仅执行一次
     • Every — 按固定时间间隔执行
   • File Watch（基于事件） 当选定目录下发生以下变化时触发：
     • 文件创建
     • 文件修改
     • 文件删除 例如：当某个文件夹中的 Excel 文件被删除时触发任务
3. 配置 Execution Flow
   • 定义任务触发后 Agent 应执行的操作
   • 可包含任意由 Agent 执行的自动化动作或工作流