qoderwake客服skill需具备意图识别、上下文继承与多通道回传能力;须先确认客服类skill已启用,再绑定企业微信或webhook通道,配置jsonpath触发策略及意图映射,并开启上下文继承开关,最后通过真实消息测试结构化响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让QoderWake在客户咨询时自动识别问题类型、匹配业务规则、生成合规回复并同步到企业微信或网页端——这要求Skill必须具备意图识别、上下文继承与多通道回传三重能力,不能仅靠单次调用完成闭环。
确认客服类Skill已启用并可被触发
第一步:在QoderWake聊天窗口中输入“我已经装了哪些 Skill?”,等待3~5秒查看返回列表。
第二步:查找含“customer-service”“faq-answer”“ticket-reply”等关键词的Skill,确认其status为enabled且builtin字段为true。
【若列表为空或无客服相关Skill,请先执行qoder skill register --file ./skills/cs-faq.yaml完成注册】
第三步:点击任意客服Skill卡片右上角“复制调用指令”,获得类似skill exec --use="cs-faq-answer"的命令,这是后续配置的基准标识。
绑定客服消息通道并注入上下文
方法一:企业微信通道直连(推荐用于私域场景)
启动QoderWork客户端→设置→通道管理→企业微信→添加通道→填入Bot ID与Secret→勾选“启用消息接收”与“自动回复开关”。
【Bot ID与Secret必须来自API模式长连接机器人,Webhook方式会导致5秒以上延迟,无法满足客服SLA】
方法二:网页端Webhook接入(适用于官网/小程序客服弹窗)
进入「开发者设置」→启用Webhook服务→获取专属Endpoint URL→在前端JS中调用fetch()向该地址POST用户消息JSON,结构需含sender_id、message_text、session_id三项必填字段。
这一步操作起来很简单,直接把前端埋点代码粘贴进客服浮窗组件即可生效。
配置Skill触发策略与响应约束
进入「触发管理」→新建事件触发→选择消息通道为“企业微信”或“Webhook”→在JSONPath过滤器中填写$.message.text,表示监听原始文本内容。
在「意图映射」区块中,为每个常见客诉类型绑定对应Skill:
• “订单未收到” → 关联order-tracking-skill
• “退款进度查不到” → 关联refund-status-skill
• “发票申请失败” → 关联invoice-generate-skill
【所有绑定的Skill必须已通过input_schema校验,否则触发时会静默失败,不报错也不响应】
最后启用「上下文继承」开关,确保同一session_id下的多轮对话能共享订单号、用户等级、历史投诉记录等关键字段。
测试真实客服链路
在企业微信中向数字员工发送:“我的订单#OD202607301122还没发货,急!”
观察QoderWake是否在3秒内返回结构化卡片:含物流预估时间、当前节点状态、人工升级按钮三项要素。
若返回纯文字或超时,检查config/core.yaml中response_format字段是否设为card,而非text。
执行qoderwake monitor --input-type text --log-level debug,实时捕获从消息接收→意图识别→Skill调度→渲染输出的完整日志流。










