qoderwake任务不触发的主因是事件源未接入、匹配规则未启用或认证被拦截；需按关键词触发、api回调、定时触发、事件总线、手动触发五类路径分别配置，确保认证、校验与启用状态完整。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QoderWake在用户提交GitHub Issue、监控系统发出告警、CRM新增客户或定时到达时自动执行修复脚本、生成报告或推送通知，但任务始终不触发——这通常不是技能没写好，而是事件源未接入、匹配规则未启用或认证环节被静默拦截。
配置关键词触发（自然语言指令驱动）
适用于内部协作中用中文/英文短语直接唤醒任务，比如“生成周报”“紧急回滚”，无需对接外部系统。
第一步：登录QoderWake管理控制台，进入「触发管理」→「关键词触发」。
第二步：点击「新建关键词触发」，填写名称如“周报指令监听”，描述写“响应用户输入中的固定短语”。
第三步：在「关键词列表」中至少填一个完整词，例如“我要看上周数据”，【必须是用户真实会说的自然语句，不能只填“数据”“上周”这类碎片词】。
第四步：勾选要激活的Skill，确保该Skill已在「技能中心」通过参数校验且状态为“启用”。
第五步：点击「保存并启用」，系统立刻将规则编译进边缘监听模块——此时只要聊天窗口里出现完整匹配的句子，就会触发。
绑定API回调触发（对接外部系统）
当你希望QoderWake响应来自钉钉审批流、Prometheus告警或自建CRM的HTTP请求时，必须完成双向认证与结构校验。
方法一：创建Webhook端点
在「触发管理」→「API回调触发」中点击「创建新端点」，系统生成唯一URL，形如https://wake.qoder.ai/v1/webhook/xyz789，【此URL不可修改，每次新建都会变化，旧URL立即失效】。
方法二：配置签名密钥
点击「生成密钥」获取HMAC-SHA256密钥字符串，**必须同步配置到调用方系统的header中，字段名固定为X-Qoder-Signature**。
方法三：定义JSON Schema校验规则
在「请求体映射」区域粘贴标准JSON Schema，明确声明必需字段，例如{"type":"object","required":["event_type","severity"],"properties":{"event_type":{"type":"string"},"severity":{"enum":["P0","P1"]}}}——任何缺失字段或值不匹配的请求，QoderWake直接返回401并丢弃。
启用定时触发（精确到秒的周期调度）
所有日志归档、指标快照、数据库备份类任务都走这条路径，它运行在独立沙盒中，自带审计日志，不依赖GUI存活。
1. 进入「触发管理」→「定时触发」→「添加计划」。
2. 输入名称如“每日02:15核心表备份”。
3. 选择时区：若团队统一按北京时间运作，务必手动切换为Asia/Shanghai，否则默认用服务器本地时区。
4. Cron表达式填七字段格式，例如0 15 2 * * * ?表示每天02:15:00执行（秒分时日月周年）。
5. 点击「关联任务」，从已启用的AI脚本或工作流中选择目标，【该任务必须已完成参数校验且状态为启用，否则保存时会提示“关联失败”】。
6. 勾选「启用审计日志记录」，每次执行后生成trace_id、开始时间、退出码及stdout摘要，存于/logs/scheduler目录下。
7. 点击「保存并激活」，调度中心立即加载该计划，下次匹配时间点自动触发。
接入事件总线（多源消息聚合触发）
当你的事件分散在Kafka、RocketMQ、阿里云EventBridge等不同消息中间件时，用事件总线统一纳管最省力。
第一步：在「触发管理」→「事件总线」中点击「新建通道」，命名如“生产环境告警总线”。
第二步：绑定消息源，选择Kafka集群地址，填写Group ID与Topic名称，点击「测试连接」确认可达性。
第三步：配置认证方式，若Kafka启用了SASL/PLAIN，则需上传JAAS配置文件并指定keytab路径；若用mTLS，则上传client.p12证书及密码。
第四步：设置JSONPath过滤规则，例如$.alert.severity == "critical" && $.alert.service == "payment"，只有完全匹配的消息才转发给QoderWake处理。
手动触发（调试与应急入口）
开发阶段验证流程逻辑、上线前做最终检查、突发故障时人工干预，都靠这个开关。
进入「触发管理」→「手动触发」→「新建入口」，填写名称“DB恢复演练入口”，描述写“仅限DBA组可见，执行前强制二次确认”。
发布前必须设置可见范围：可选“指定角色”（如DBA）、“指定用户组”（如运维中心）、或“全公司”，【未设置可见范围的任务不会出现在任何人的触发面板中】。
开启「二次确认」开关，用户点击执行时会弹出带红色警告图标的确认框，内容为任务名称+执行后果说明，点击“确定”后才真正下发。
点击「发布」，该入口立即出现在对应人员的QoderWake客户端右下角快捷面板中。
