qoderwake支持三种定时唤醒机制：一、cron表达式配置内置定时触发；二、事件+时间窗口复合触发；三、外部调度器调用webhook接口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望QoderWake在特定时间自动执行周期性报表生成或系统巡检任务，则需通过其触发规则模块配置定时唤醒机制。以下是实现该目标的具体操作路径与方法：
一、配置基于Cron表达式的定时触发规则
QoderWake支持标准Cron语法，可在后台定义精确到分钟级的执行周期，适用于固定时间点生成财务日报、网络设备巡检快照等场景。该方式不依赖外部调度器，由QoderWake内部调度引擎直接解析并触发。
1、登录QoderWake管理控制台，进入【数字员工管理】→【触发规则】页面。
2、点击“新建规则”，在规则类型中选择定时触发。
3、在Cron表达式输入框中填写对应周期，例如：每月1日02:00执行报表生成可填入0 0 2 1 * ?；每周一至周五09:30执行网络巡检可填入0 30 9 ? * MON-FRI。
4、在“关联任务”下拉菜单中选择已预设的报表生成流程或巡检脚本，确保该任务已通过Connector接入对应数据源（如ERP、SNMP、SSH设备列表）。
5、启用“执行前环境校验”，勾选验证目标系统可用性与确认权限沙盒状态正常两项，防止因下游服务离线导致误触发。
二、绑定业务事件+时间窗口的复合触发模式
当任务需结合业务节点（如月结完成、备份成功）与时间约束（如“月结后2小时内且非工作时间”）时，可采用事件驱动叠加时间窗的复合策略。该方式适用于对时效性与上下文强依赖的报表与巡检场景。
1、在【触发规则】页面点击“新建规则”，选择规则类型为事件+时间窗口触发。
2、在“基础事件”区域配置上游信号源，例如选择Connector接入的ERP系统，监听月度关账完成事件或监控系统发出的全量备份成功通知。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、在“时间窗口”设置中指定允许触发的时间段，例如设置为当日22:00至次日05:00，避免占用生产高峰资源。
4、在“关联动作”中绑定报表生成模板或巡检指令集，并开启失败重试三次，间隔15分钟选项。
5、保存前点击“测试触发逻辑”，系统将模拟事件流入并校验时间窗匹配结果，确认无误后启用规则。
三、通过外部调度器调用QoderWake Webhook接口
对于已有成熟调度体系（如Airflow、Jenkins、GitHub Actions）的企业，可绕过QoderWake内置调度，改由外部系统按需发起HTTP请求唤醒指定数字员工。该方式便于统一纳管所有自动化作业生命周期。
1、进入【数字员工详情页】，在【API接入】模块复制当前员工的专属Webhook URL及签名密钥（Secret）。
2、在外部调度器中创建新任务，配置HTTP POST请求，Header中加入X-QoderWake-Signature字段，值为使用密钥对请求体进行HMAC-SHA256计算后的十六进制字符串。
3、请求Body为JSON格式，必须包含字段：{"task_id": "report_monthly_finance", "params": {"period": "202604"}}，其中task_id需与QoderWake中预注册的任务标识完全一致。
4、在外部调度器中设定执行周期，例如GitHub Actions中使用schedule: '0 2 1 * *' 实现每月1日2点调用。
5、QoderWake接收到合法签名请求后，将立即启动对应任务，并将执行日志同步写入独立审计通道，供后续溯源。
