Files

158 lines
8.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: sales-dashboard-pipeline
displayName: 销售数据看板生成
description: 当用户上传销售数据 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 能力限制