Skills
skills/skills.netease.im/upselld-scenario-html

upselld-scenario-html

SKILL.md

简介

基于 Top300 问法数据，生成可直接在浏览器查看的增购推荐场景 HTML 报告。

v3.3 优化更新：

  • 🎯 智能场景识别：更精准的Agent场景自动识别
  • 📊 增强聚类分析：改进的K-means++算法，更合理的场景分组
  • 🔄 改进流程图生成：更清晰的业务流程可视化
  • 📈 优化HTML报告布局：更好的阅读体验和交互设计
  • 📊 ECharts 可视化图表：趋势图、柱状图、漏斗图、词云
  • 🎛️ 交互式筛选：按场景、关键词、排序方式筛选
  • 🧠 行业知识库匹配：自动匹配最佳实践配置
  • 🤖 Agent 配置建议：意图、实体、工具、提示词模板

支持自定义行业和核心关注点，生成包含精美流程图的个性化方案。

何时使用此 Skill

当用户需要：

  • 向客户推荐 Agent 增购场景
  • 分析当前机器人能力缺口
  • 生成可视化数据报告
  • 识别高价值自动化场景

处理流程

Step 1: 收集客户信息
├── 客户名称（必需）
├── 行业（必需，用户自定义输入）
└── 核心关注点（必需，用户自定义输入）

Step 2: 收集数据文件
├── Top300 问法（CSV/XLSX，必需）
├── 热门问法及解决率（CSV/XLSX，可选）
└── 转人工会话（CSV/XLSX，可选）

Step 3: 数据验证与加载
├── 检测文件格式（CSV/XLSX）
├── 验证必需字段
└── 转换为统一数据结构

Step 4: 数据分析（增强版）
├── 分析 Top300 高频问题分类
├── 识别高频但机器人未覆盖的问题
├── 生成趋势数据（模拟30天）
├── 统计高频关键词
└── （如有）分析热门问法解决率

Step 5: 场景识别与流程设计（智能化）
├── 基于 Top300 数据识别高频场景
├── 结合客户行业定制场景名称
├── 根据关注点突出不同价值点
├── 匹配行业知识库最佳实践
├── 生成意图/实体/工具配置建议
└── 生成详细的 Agent 运作流程图

Step 6: 生成可视化报告（v2.0增强）
├── 生成 HTML 文件
├── 嵌入 ECharts 图表（趋势图、柱状图、漏斗图、词云）
├── 嵌入 Mermaid 流程图
├── 添加交互式筛选功能
├── 包含详细 Agent 配置建议
├── 包含 ROI 分析
└── 突出客户关注点的价值

Step 7: 交付结果
├── 发送 HTML 文件
└── 提供使用说明

前置条件

必需信息

  1. 客户名称 - 用于报告标题
  2. 行业 - 用户自定义输入（如：跨境电商、在线教育、互联网保险等）
  3. 核心关注点 - 用户自定义输入（如：降低客服成本、提升首响速度、减少投诉率等）

必需数据文件

支持 CSV 或 XLSX 格式

Top300 问法

  • 必需字段：question（问题）, frequency（提问次数）
  • 可选字段：answer（当前回答）, category（分类）

可选数据文件

热门问法及解决率

  • 字段：question, category, total_count, solved_count, solved_rate
  • 作用：识别解决能力缺口，优化场景推荐

转人工会话

  • 字段：session_id, user_message, timestamp, channel
  • 作用：识别完全无法处理的问题类型

使用方式

触发语

  • "生成增购推荐场景报告"
  • "分析机器人能力缺口"
  • "制作 Agent 场景方案"
  • "使用 v2 生成报告"（使用增强版）

执行步骤

Step 1: 收集客户信息

请提供客户信息：
1. 客户名称：__________
2. 行业：__________（请自由描述，如：跨境电商、在线教育等）
3. 核心关注点：__________（请自由描述，如：降低客服成本、提升响应速度等）

Step 2: 收集数据文件

请提供数据文件（支持 CSV 或 XLSX）：

【必需】
1. Top300 问法文件
   - 必需字段：question（问题）, frequency（提问次数）
   - 可选字段：answer（当前回答）, category（分类）

【可选】
2. 热门问法及解决率（如有）
3. 转人工会话数据（如有）

Step 3: 执行分析

v1.2 版本（基础版）：

python3 scripts/generate_html.py \
  --top300 top300.xlsx \
  --customer "客户名称" \
  --industry "行业描述" \
  --focus "核心关注点" \
  --output report.html

v2.0 版本（增强版 - 推荐）：

python3 scripts/generate_html_v2.py \
  --top300 top300.xlsx \
  --customer "客户名称" \
  --industry "行业描述" \
  --focus "核心关注点" \
  --output report_v2.html

Step 4: 交付结果

  • 发送生成的 HTML 报告
  • 说明报告内容和使用方法

输出

v1.2 版本输出

生成 report.html 文件，内容根据客户关注点动态调整。

v2.0 版本输出（增强版）

生成 report_v2.html 文件，包含以下增强内容：

章节 v2.0 增强内容
交互式筛选栏 按场景筛选、排序方式选择、关键词搜索
数据可视化 ECharts 趋势图（咨询量+解决率）、分类柱状图、场景漏斗图、高频词云
Agent 配置建议 每个场景包含：意图识别配置、实体抽取配置、工具调用配置、提示词模板
行业最佳实践 基于行业知识库自动匹配预期解决率、成本节省、关键指标
流程图 更详细的 Mermaid 流程图，带样式定义

通用结构

章节 内容
Dashboard 关键指标卡片（Top300数量、高频场景数、预估ROI）
高频问题分析 Top300 分类统计、高频问题列表
Agent 场景推荐 3-5个场景，每个包含详细流程图
ROI 分析 根据关注点突出不同指标
下一步行动 实施计划建议

根据关注点的差异化输出

报告会根据用户提供的"核心关注点"自动调整强调内容：

  • 降本/成本相关 → 突出成本节省、ROI计算
  • 效率/速度相关 → 突出处理效率、响应速度
  • 满意度/质量相关 → 突出解决率、服务质量
  • 其他自定义关注点 → 在报告中相应位置突出

数据格式示例

Top300 问法（CSV/XLSX）- 最简格式

question,frequency
"产品价格是多少",1250
"怎么退款",890
"有什么功能",650

Top300 问法（CSV/XLSX）- 完整格式

question,answer,category,frequency
"产品价格是多少","99-999元","价格咨询",1250
"怎么退款","登录账户申请","售后服务",890
"有什么功能","智能客服、工单系统","功能介绍",650

热门问法（CSV/XLSX）- 可选

question,category,total_count,solved_count,solved_rate
"怎么退款","售后",800,200,25%
"系统报错","技术支持",600,150,25%

场景识别逻辑

基于 Top300 的场景识别

  1. 问题分类聚类

    • 根据 question 内容提取关键词
    • 按相似度进行聚类
    • 统计每个分类的总频次

  2. 高频场景识别

    • 频次 > 100 的问题归类为高价值场景
    • 结合行业关键词优化场景名称
    • 生成对应的 Agent 流程图

  3. 优先级排序

    • 按总频次排序
    • 取 Top 5 作为推荐场景

流程图生成

使用 Mermaid 生成精美流程图，包含：

  • 开始/结束节点（不同颜色）
  • 处理步骤（意图识别、信息查询、生成回复等）
  • 决策分支（是否解决）
  • 转人工条件
  • 样式美化

示例流程图：

flowchart TD
    Start([开始]) --> Input[用户输入]
    Input --> Intent[意图识别]
    Intent --> Process[信息处理]
    Process --> Check{{是否解决}}
    Check -->|是| Success[✓ 完成]
    Check -->|否| Human[转人工]
    Success --> End1([结束])
    Human --> End2([结束])
    
    style Start fill:#e0e7ff,stroke:#6366f1
    style End1 fill:#d1fae5,stroke:#10b981
    style End2 fill:#fee2e2,stroke:#ef4444
    style Check fill:#fef3c7,stroke:#f59e0b

错误处理

错误场景 处理方式
文件格式不支持 提示仅支持 CSV/XLSX
Top300 缺少必需字段 提示需要 question 和 frequency 字段
数据为空 提示提供有效数据
生成失败 报告错误原因，建议检查数据格式

文件结构

upselld-scenario-html/
├── SKILL.md                 # 本文件
├── scripts/
│   ├── generate_html.py     # 主生成脚本
│   └── flowchart_generator.py # 流程图生成器
├── references/              # 参考文档目录
└── assets/                  # 资源文件目录
    └── prompts/            # 提示词模板

依赖

  • Python 3.8+
  • pandas（CSV/XLSX 处理）
  • openpyxl（XLSX 支持）

更新记录

版本 日期 更新内容
2.0.0 2025-03-25 重大更新：ECharts可视化图表、交互式筛选、行业知识库匹配、Agent配置建议
1.2.0 2024-03-19 简化输入要求，Top300只需question/frequency，行业和关注点自由输入
1.1.0 2024-03-19 支持 XLSX 格式，增加客户关注点，优化流程图
1.0.0 2024-03-19 初始版本

反馈

如有问题或建议，请联系开发团队。

Installs
1
Source
skills.netease.…52b6036f
First Seen
Apr 24, 2026