SuperAPI AI 工具集

voice-of-customer-synthesizer

通用与其它

查看项目

更新于 10-16 08:03

技能介绍

用途:回答“客户在说什么”“为产品团队生成 VoC 报告”“汇总上季度客户反馈”“出现了哪些主题”等问题。

主要能力:先用确定性、无需密钥的归一化脚本把多来源反馈合并为一个语料,输出标准行 {source, type, date, customer, segment, text, rating, sentiment_hint} 及各来源计数和情感提示分布;随后由智能体自下而上做主题聚类(被 3 个以上客户或 3 个以上来源提及的主题优先),按频率×严重度排序,生成含原话引用、受影响分群、根因假设、留存/扩展/获客影响的主题卡片,并给出情感概览、来源对比、分群分析、与上一周期语料的趋势对比,以及按产品(P0/P1/P2)、客户成功、市场拆分的行动建议。

使用方式:可选第一步抓取外部评论,需 APIFY_API_TOKEN: python3 ${SKILL_DIR}/scripts/scrape_reviews.py --product "Acme" --url "https://www.g2.com/products/acme/reviews" --months 6 --output ${WORKSPACE}/scraped_reviews.json 第二步归一化,无需密钥: python3 ${SKILL_DIR}/scripts/normalize_feedback.py --source "tickets=${WORKSPACE}/tickets.csv" --source "nps=${WORKSPACE}/nps.csv" --source "churn_surveys=${WORKSPACE}/churn.csv" --source "feature_requests=${WORKSPACE}/features.csv" --reviews-json ${WORKSPACE}/scraped_reviews.json --output ${WORKSPACE}/corpus.json 每个 --source 为 type=path.csv,列名不区分大小写匹配 date、customer、segment、text、rating、sentiment。Slack 反馈频道可通过 Slack 工具读取后作为额外来源传入。第三步由智能体基于 corpus.json 聚类、分析与建议;高数据量时可选用 pinecone/qdrant 做语义聚类。

输出:voc-report-[YYYY-MM-DD].md,含执行摘要、情感概览(与上期净分对比)、按影响排序的顶级主题(引用+行动+负责人)、客户喜爱/期望/痛点、趋势对比、分团队行动项及全部主题卡片附录,并附到工作区和 Agent Teams 频道。

限制:必需凭据无,脚本层不含 LLM 密钥,合成由智能体完成;APIFY_API_TOKEN、SLACK_BOT_TOKEN、PINECONE_API_KEY/QDRANT_URL 均为可选。来源越多主题置信度越高,需注意来源重叠;趋势检测需已存上一周期语料,首次运行跳过趋势。建议须与证据强度(提及数、来源数、流失信号)挂钩;Apify 按结果计费,应限制时间窗口并缓存抓取结果。