qoderwake需每日自动统计top5咨询热点并推送，首先配置日志导出任务限定字段、时间窗口与存储路径，再通过语义聚类（内置模板或自定义脚本）识别问题簇，最后渲染markdown日报并多通道推送。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让QoderWake每天自动统计用户咨询中最常出现的5个问题，并推送到指定IM群或邮件列表，避免人工翻查聊天记录、漏判热点、响应滞后。
配置AI驱动的咨询日志抓取与清洗任务
这一步必须先建立原始数据源，否则后续统计无从谈起。QoderWake不主动存储原始对话，需显式启用日志导出通道并限定字段范围，否则会因加载全量会话导致内存溢出或超时失败。
1、登录QoderWake管理控制台，进入【数据源管理】→【对话日志】模块。
2、点击「新建日志导出任务」，名称设为“客服咨询原始流-近24h”。
3、在「时间窗口」中选择“过去24小时”，勾选「仅导出已归档会话」，避免拉取正在处理中的不稳定会话。
4、于「字段白名单」中只保留：session_id、user_id、intent_label、raw_text、timestamp、channel_type；【务必取消勾选message_id和full_context字段】，这两项单条体积超2MB，批量拉取将直接触发连接池熔断。
5、设置导出目标为内置对象存储桶qoder-log-bucket，路径前缀为/daily-consult-raw/，格式选Parquet（压缩率高、Schema强校验）。
部署TOP5热点问题自动聚类工作流
原始日志只是文本流，必须通过语义聚类才能识别真实问题簇。不能依赖关键词频次——用户问法千差万别，“怎么退款”“退钱流程”“钱还没到账”本质是同一问题，需用向量相似度聚合。
方法一：使用内置Quest模板快速启动
1、进入【自动化】→【Quest工作台】，点击「从模板创建」→ 选择“咨询热点聚类_v2.3”。
2、在参数面板中绑定上一步生成的日志路径：/daily-consult-raw/2026-06-14/*.parquet。
3、将「聚类粒度」设为intent_label+raw_text双字段融合，「最小簇大小」调至8（过滤噪声提问），「最大输出簇数」设为5。
4、勾选「启用意图泛化映射」，系统会自动将“发货慢”“还没发”“物流没更新”统一映射为【物流时效延迟】标准标签。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
方法二：手动编写聚类脚本（适合需自定义权重场景）
1、新建Python AI脚本任务，名称为“定制热点聚类”。
2、粘贴以下核心逻辑（注意替换YOUR_EMBED_MODEL_ID）：
from qoderwake.ml import embed, cluster
logs = load_parquet("/daily-consult-raw/2026-06-14/*.parquet")
vectors = embed(texts=logs["raw_text"], model="YOUR_EMBED_MODEL_ID")
clusters = cluster(vectors, n_clusters=5, min_cluster_size=8)
top5 = summarize_clusters(clusters, logs, top_k=1)
save_json(top5, "/hotspot-daily/2026-06-14.json")
3、在「执行环境」中选择Performance内核，确保向量计算精度；【禁用缓存】，避免复用昨日向量导致新问题未被纳入。
设置日报生成与多通道推送
第一步生成JSON结构化结果，第二步必须将其渲染为可读格式并分发。若跳过模板渲染直接发原始JSON，运营人员无法快速定位问题。
① 在Quest工作台中，新建任务“热点日报生成”，类型选“Markdown模板渲染”。
② 绑定输入源为上一步输出的/hotspot-daily/2026-06-14.json。
③ 模板内容填入：
## ? 6月14日咨询热点TOP5
1. 【{cluster_0.label}】（{cluster_0.size}次）
典型问法：{cluster_0.samples[0]}、{cluster_0.samples[1]}
2. 【{cluster_1.label}】（{cluster_1.size}次）
典型问法：{cluster_1.samples[0]}、{cluster_1.samples[1]}
……
? 建议动作：检查FAQ第{cluster_0.faq_ref}条、同步更新知识库版本v2.7
④ 输出目标设为：本地文件系统 /report/hotspot-daily/2026-06-14.md，并启用「自动覆盖同名文件」。
⑤ 点击「添加推送动作」，选择渠道：飞书群（Webhook URL已预置）、企业微信应用（AgentID已授权）、指定邮箱组（admin@company.com）。
⑥ 设置推送时机为“文件生成后立即执行”，勾选「附带PDF附件」（系统自动将MD转为带页眉页脚的PDF）。
