> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 定时触发器

`Schedule Trigger` 用于按时间计划自动触发数字专家工作流，适合无人值守的周期性任务。

## 适用场景

* 定时生成日报、周报、巡检报告
* 定时同步外部数据并触发后续分析
* 低峰时段执行批处理任务

## 关键配置

Schedule Trigger 的核心配置包括：

* `enabled`：是否启用
* `cron`：Cron 表达式（必填）
* `task`：注入工作流的默认任务文本（必填）

发布前会检查 `cron` 是否已提供；缺失时工作流校验会报错。

## 运行机制

1. **publish 阶段**：
   * 先删除同名旧任务（防止重复注册）；
   * 再按 `cron` 创建新任务并启动。
2. **触发执行阶段**：
   * 定时任务触发后，向工作流注入 `task` 文本；
   * 由后续 Agent/工具/知识库节点继续处理。
3. **stop 阶段**：
   * 停止并删除对应的 Cron 任务，释放调度资源。

## 启动恢复策略

Schedule Trigger 使用 `bootstrap.mode = replay_publish`：

* 系统重启后会重放发布逻辑，自动恢复定时任务；
* 适合需要“重启后继续按计划执行”的触发场景。

## 关联功能

* 触发器节点总览： [工作流触发器](../../workflow/trigger/)
* 数字专家多 Channel 接入： [数字专家](../../agent/agent/)
* 插件触发器总览： [Trigger 插件](./)
