--- 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 能力限制