需配置多通道异常通知机制：一、启用事件驱动告警开关；二、配置飞书+邮件双通道推送；三、绑定人工介入触发条件；四、关联腾讯云可观测平台事件总线；五、验证异常通知链路完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 QoderWake 执行关键任务时，希望在异常发生（如任务失败、超时、权限拒绝）时立即获知并触发人工介入，则需配置多通道异常通知机制。以下是完成该配置的具体步骤：
一、启用事件驱动告警开关
QoderWake 的异常通知依赖于底层事件总线的实时捕获能力，必须先开启核心事件监听功能，才能触发后续通知逻辑。该开关控制所有异常类型是否进入告警流程，是整个通知链路的总闸门。
1、登录 QoderWake 管理控制台，进入「数字员工设置」>「运行时策略」页面。
2、找到「异常事件上报」选项，将其状态切换为开启。
3、在下拉菜单中勾选需监控的异常类型：taskExecuteFailed、taskTimeout、taskPermissionDenied、taskPreempted。
4、点击「保存策略」，系统将自动重启事件监听服务，生效时间小于3秒。
二、配置飞书+邮件双通道推送
为确保关键异常不被遗漏，QoderWake 支持同时向飞书与企业邮箱投递结构化告警消息，二者互为冗余备份，覆盖移动端与桌面端触达场景。
1、进入「通知管理」>「通道配置」，点击「添加新通道」。
2、选择「飞书机器人」，粘贴已创建的飞书群机器人 Webhook 地址，启用「消息加急标记」和锁屏震动提醒选项。
3、再次点击「添加新通道」，选择「SMTP 邮件」，填写企业邮箱 SMTP 服务器地址、端口、发件人账号及应用密码。
4、在邮件模板编辑区，插入变量 {{task_id}}、{{error_code}}、{{failed_at}}，确保每封邮件携带可追溯的原始上下文。
5、点击「测试推送」按钮，验证两条通道均能收到含相同错误摘要的告警消息。
三、绑定人工介入触发条件
当任务失败达到预设严重等级或涉及敏感操作时，QoderWake 将暂停自动重试，转而发起人工确认流程，防止错误扩散。该机制通过权限红线与事件标签联合判定。
1、进入「权限与合规」>「人工介入规则」，点击「新建规则」。
2、设置触发条件：选择事件类型为 taskExecuteFailed，并添加标签匹配项 "critical:true" 或 "operation:payment|user_data_delete"。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、指定介入方式为「飞书交互卡片」，填写审批人飞书 OpenID 列表（支持最多5人轮询）。
4、设置超时策略：若300秒内无响应，则自动升级至下一审批人；若全部超时，则强制触发邮件归档并标记为P0级阻断事件。
5、保存规则后，该策略将实时加载至数字员工运行沙盒中。
四、关联腾讯云可观测平台事件总线
为实现跨平台统一告警治理，QoderWake 可将异常事件同步至腾讯云事件总线，复用已有告警通道（如短信、企业微信、电话外呼），避免告警孤岛。
1、在「集成中心」>「云服务连接器」中，启用「腾讯云事件总线（TEB）」插件。
2、输入目标地域（如广州）、事件集名称（default）、角色ARN（具备 tione:PutEvents 权限）。
3、在事件映射配置中，将 QoderWake 内部事件名 taskExecuteFailed 映射为云事件类型 qoderwake:ErrorEvent:taskExecuteFailed。
4、勾选「携带完整执行上下文（含DAG节点快照、参数哈希、内存堆栈）」选项。
5、点击「授权并同步」，系统将返回事件总线注册成功标识及事件示例 JSON。
五、验证异常通知链路完整性
真实异常场景不可控，因此必须通过受控的模拟注入方式验证全链路是否就绪，包括事件捕获、通道分发、人工卡响应、日志归档四个环节。
1、在「调试工具」>「事件模拟器」中，选择「构造失败事件」模板。
2、填入测试任务 ID、模拟错误码 ERR_PERMISSION_DENIED_403、附加标签 critical:true。
3、点击「发送测试事件」，观察控制台实时日志流中是否出现 event_status: dispatched 标记。
4、检查飞书群是否在5秒内收到带「【QoderWake P0】人工介入请求」标题的消息卡片。
5、确认企业邮箱是否在12秒内收到含附件 error_snapshot.zip 的告警邮件。
