158 lines
8.1 KiB
Markdown
158 lines
8.1 KiB
Markdown
---
|
||
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 能力限制
|