Initial commit: workspace files

This commit is contained in:
2026-10-22 22:33:51 +08:00
commit d82d903639
8 changed files with 4695 additions and 0 deletions
+87
View File
@@ -0,0 +1,87 @@
---
name: chart-qa-assistant
displayName: 图表数据问答助手
description: 当用户基于已有图表或数据进行追问、分析、对比时触发。通过衡石智能问数引擎创建对话、发起问答,获取图表数据并以结构化方式呈现。
---
# 图表数据问答助手
基于衡石 BI 平台的智能问数引擎,帮助用户对已有图表和业务数据进行自然语言问答、趋势分析和对比分析。
## 触发条件
- 用户基于已生成的图表追问(如"哪个区域最高""环比增长多少")
- 用户直接用自然语言查询业务数据(如"上月销售额排名")
- 用户要求对数据进行对比、趋势分析或排名
- 用户要求查看历史问答或搜索已有分析结果
## 工作流程
### 1. 意图识别
判断用户问题类型:
- **数据查询**:查询具体指标数值(销售额、订单量等)
- **趋势分析**:时间序列变化(月度趋势、同比增长等)
- **排名对比**:区域/产品/客户排名
- **占比分析**:各部分占总体比例
- **历史回溯**:搜索之前的问答记录
### 2. 对话管理
使用衡石问数引擎管理对话上下文:
1. 使用 {mcp: hs-metric-insight-api/hengshi-list-conversations} 查询已有对话
2. 如果是新问题,使用 {mcp: hs-metric-insight-api/hengshi-create-conversation} 创建对话
3. 如果延续已有对话,获取对应 conversationId
### 3. 发起问答
1. 使用 {mcp: hs-metric-insight-api/hengshi-create-chat} 发起问答,type 设为 workflow
2. 使用 {mcp: hs-metric-insight-api/hengshi-get-chat} 获取回答结果
3. 如果结果包含 charts 对象,使用 {mcp: hs-metric-insight-api/hengshi-get-chart-data} 获取图表明细数据
### 4. 结果呈现
根据数据类型选择呈现方式:
| 数据类型 | 呈现方式 |
|---------|---------|
| 数值查询 | 直接展示数值,标注单位和时间范围 |
| 排名数据 | 按排名顺序列表展示,标注关键指标 |
| 趋势数据 | 描述变化趋势,标注峰值和谷值 |
| 对比数据 | 表格对比,标注差异和变化率 |
| 图表数据 | 描述图表类型和关键数据点 |
### 5. 追问与迭代
- 用户可基于当前结果继续追问
- 使用 {mcp: hs-metric-insight-api/hengshi-refine-question} 补全或改写模糊问题
- 使用 {mcp: hs-metric-insight-api/hengshi-regenerate-chat} 重新生成不满意的回答
- 使用 {mcp: hs-metric-insight-api/hengshi-search-chats} 搜索历史问答记录
## 问题改写策略
当用户问题模糊时,主动补充关键信息:
- 缺少时间范围:追问"请问您要查询哪个时间段的数据?"
- 缺少指标类型:追问"您关注的是销售额、订单量还是其他指标?"
- 缺少维度:追问"您需要按区域、产品还是客户维度分析?"
## 失败处理
- 对话创建失败:提示用户检查平台权限
- 问答返回空结果:说明未找到匹配数据,建议调整查询条件
- 图表数据获取失败:说明图表可能已过期或数据源已变更
- 平台服务不可用:明确告知服务状态,建议稍后重试
## 安全边界
- 不伪造或编造数据结果
- 不访问或泄露用户凭证
- 对敏感数据(薪资、成本等)谨慎处理
- 删除对话或修改标题等写操作前要求用户确认
## 限制
- 只能查询衡石 BI 平台中已配置的数据集和应用
- 数据更新取决于平台的刷新计划,非实时
- 图表类型和样式受平台能力限制