Files
adi-workspace/sales-dashboard-pipeline/SKILL.md
T

8.1 KiB
Raw Blame History

name, displayName, description
name displayName description
sales-dashboard-pipeline 销售数据看板生成 当用户上传销售数据 CSV/Excel 文件并希望生成可视化图表看板时触发。自动创建图表、组装仪表盘,并支持基于看板的智能问数。

销售数据看板生成

基于衡石数据集,通过智能问数获取数据,生成交互式 HTML 仪表盘。

触发条件

  • 用户提到"看板""仪表盘""dashboard""可视化""分析"等关键词
  • 用户要求对销售数据进行可视化展示
  • 用户提到"生成报表""做图表""画趋势图"等需求

前置条件

  • 数据集已存在:datasetId=1, appId=14663(小型阀体外壳销售记录大宽表)
  • 如果数据集不存在,需要先手动在衡石平台创建

数据集字段说明

维度字段:

  • 时间维度:订单日期、交货日期
  • 分类维度:销售大区、销售部门、销售员、客户名称、客户级别、客户城市、产品名称、材质、铸造方式、表面处理、订单状态

度量字段:

  • 订单数量、单价、订单金额、材料成本、铸造成本、机加工成本、毛利润、毛利率

工作流程

1. 确认分析目标

与用户确认:

  • 分析时间范围(全部/最近一年/最近一月/自定义)
  • 关注的维度(区域/产品/客户/销售员)
  • 重点指标(销售额/利润/毛利率/订单量)

2. 通过智能问数获取数据

使用 {mcp: bi-metric-insight/bi-create-conversation}、{mcp: bi-metric-insight/bi-create-chat}、{mcp: bi-metric-insight/bi-get-chat}(轮询,每次传入随机 UUID 作为 randomCode)、{mcp: bi-metric-insight/bi-get-chart-data} 获取各图表数据:

步骤:

  1. 调用 {mcp: bi-metric-insight/bi-create-conversation} 创建对话,传入 appId=14663, datasetId=1
  2. 针对每个图表,调用 {mcp: bi-metric-insight/bi-create-chat} 发起自然语言查询
  3. 轮询调用 {mcp: bi-metric-insight/bi-get-chat} 获取回答结果(每次轮询传入随机生成的 UUID 作为 randomCode 参数,直到返回最终结果)
  4. 调用 {mcp: bi-metric-insight/bi-get-chart-data} 获取图表数据

需要获取的数据:

图表 查询语句 预期数据结构
KPI-总销售额 "总销售额是多少" 单一数值
KPI-总利润 "总毛利润是多少" 单一数值
KPI-平均毛利率 "平均毛利率是多少" 百分比数值
KPI-订单总数 "总订单数量是多少" 单一数值
区域销售对比 "各销售大区的订单金额对比" 数组:[{region, amount}]
产品销售占比 "各产品的订单金额占比" 数组:[{product, amount}]
月度销售趋势 "按月统计订单金额趋势" 数组:[{month, amount}]
材质分布 "各材质的订单金额分布" 数组:[{material, amount}]
销售员排名 "销售员订单金额排名TOP10" 数组:[{salesperson, amount}]
客户级别分布 "各客户级别的订单数量分布" 数组:[{level, count}]

3. 生成 HTML 仪表盘

参考模板:assets/dashboard-template.html 提供了完整的 HTML 结构和 ECharts 配置示例。生成时复制模板并替换占位符数据。

使用获取的数据生成 HTML 文件,包含以下结构:

布局设计:

┌─────────────────────────────────────────────────────────┐
│  KPI卡片区                                               │
│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐                   │
│  │总销售│ │总利润│ │毛利率│ │订单数│                   │
│  └──────┘ └──────┘ └──────┘ └──────┘                   │
├─────────────────────────────────────────────────────────┤
│  ┌─────────────────────┐ ┌─────────────────────┐       │
│  │ 区域销售对比(柱状图) │ │ 产品销售占比(饼图)   │       │
│  └─────────────────────┘ └─────────────────────┘       │
├─────────────────────────────────────────────────────────┤
│  ┌─────────────────────────────────────────────┐       │
│  │ 月度销售趋势(折线图)                         │       │
│  └─────────────────────────────────────────────┘       │
├─────────────────────────────────────────────────────────┤
│  ┌──────────┐ ┌──────────────┐ ┌──────────┐          │
│  │材质分布  │ │销售员排名TOP10│ │客户级别  │          │
│  │(环形图)  │ │(条形图)      │ │(饼图)    │          │
│  └──────────┘ └──────────────┘ └──────────┘          │
└─────────────────────────────────────────────────────────┘

技术要求:

  • 使用 ECharts 5.x 进行图表渲染
  • 响应式布局,支持不同屏幕尺寸
  • 数据从智能问数结果中提取并嵌入到 HTML 中
  • 文件命名:销售分析看板-{用户账号}-{日期}.html

HTML 生成步骤:

  1. 创建 HTML 文件,引入 ECharts CDN
  2. 编写 CSS 样式(响应式网格布局)
  3. 为每个图表创建容器 div
  4. 将智能问数获取的数据转换为 ECharts 配置
  5. 初始化每个图表并渲染
  6. 添加标题和说明文字

4. 结果输出

  • 提供生成的 HTML 文件路径
  • 展示关键数据摘要(总销售额、总利润、平均毛利率等)
  • 提示用户可以基于看板继续追问

5. 智能问数(可选)

用户可基于已创建的看板进行自然语言追问:

调用工具:

  • 使用 {mcp: bi-metric-insight/bi-create-conversation} 创建或复用对话
  • 使用 {mcp: bi-metric-insight/bi-create-chat} 发起问答
  • 轮询调用 {mcp: bi-metric-insight/bi-get-chat} 获取回答(每次轮询传入随机 UUID 作为 randomCode,直到返回最终结果)
  • 使用 {mcp: bi-metric-insight/bi-get-chart-data} 获取图表明细

示例问题:

  • "西部大区的毛利率是多少?"
  • "哪个产品的订单金额最高?"
  • "各区域的成本结构对比"
  • "上月销售额环比增长了多少?"

输入要求

  • 数据集 ID 和应用 ID(默认:datasetId=1, appId=14663)
  • 可选:分析时间范围、关注维度、重点指标

仪表盘管理

使用 {mcp: adi-metric-tool/bi_app_get_apps} 查询应用列表,使用 {mcp: adi-metric-tool/bi_dashboard_get_apps_appid_dashboards_dashboardid_42d6e007} 获取仪表盘配置详情。

输出格式

  • HTML 文件:可离线查看的交互式仪表盘
  • 数据摘要:关键指标数值
  • 图表预览:主要图表的数据展示

失败处理

  • 智能问数返回空结果:提示用户检查数据集是否存在数据
  • 数据集不存在:提示用户先在衡石平台创建数据集
  • 图表数据获取失败:说明失败原因,跳过该图表继续生成其他部分
  • HTML 生成失败:提示检查文件写入权限

限制

  • 依赖现有数据集(datasetId=1, appId=14663)
  • 智能问数依赖 ChatBI 引擎的理解能力,查询结果可能需要调整
  • HTML 文件为静态快照,数据为生成时的快照
  • 图表样式受 ECharts 能力限制