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 平台中已配置的数据集和应用
- 数据更新取决于平台的刷新计划,非实时
- 图表类型和样式受平台能力限制
+72
View File
@@ -0,0 +1,72 @@
{
"schemaVersion": 1,
"skillId": "67a72b03-9457-414c-8cc1-37f655249c3a",
"id": null,
"name": "chart-qa-assistant",
"displayName": "图表数据问答助手",
"description": "当用户基于已有图表或数据进行追问、分析、对比时触发。通过衡石智能问数引擎创建对话、发起问答,获取图表数据并以结构化方式呈现。",
"icon": null,
"skillType": "CUSTOM",
"createTime": "2026-10-19T16:05:07.516Z",
"updateTime": "2026-10-19T16:05:07.516Z",
"createdBy": {
"userId": "dongsk@digiwin.com",
"userName": "董书康"
},
"isDraft": true,
"variables": [],
"resourceData": {
"plugins": [],
"mcps": [
{
"id": "0192ca74-b1bc-4c6c-9368-a925b8e63671",
"name": "hs-metric-insight-api",
"toolName": "hengshi-list-conversations",
"toolId": "2ed3efec-9e22-44b4-ae1c-b9c56431b6a4"
},
{
"id": "0192ca74-b1bc-4c6c-9368-a925b8e63671",
"name": "hs-metric-insight-api",
"toolName": "hengshi-create-conversation",
"toolId": "74f5a8f4-ff8e-4eaa-9f78-13e6cec38886"
},
{
"id": "0192ca74-b1bc-4c6c-9368-a925b8e63671",
"name": "hs-metric-insight-api",
"toolName": "hengshi-create-chat",
"toolId": "055c1366-cff1-4a3f-aada-8b7644f59722"
},
{
"id": "0192ca74-b1bc-4c6c-9368-a925b8e63671",
"name": "hs-metric-insight-api",
"toolName": "hengshi-get-chat",
"toolId": "9ea1b6d9-ab00-42af-a56a-b6fa30edcd44"
},
{
"id": "0192ca74-b1bc-4c6c-9368-a925b8e63671",
"name": "hs-metric-insight-api",
"toolName": "hengshi-get-chart-data",
"toolId": "20413d08-1cc9-4bb9-aab6-637a0c4487bf"
},
{
"id": "0192ca74-b1bc-4c6c-9368-a925b8e63671",
"name": "hs-metric-insight-api",
"toolName": "hengshi-refine-question",
"toolId": "b90b2eb2-66bc-45c6-8e3b-d19be4778280"
},
{
"id": "0192ca74-b1bc-4c6c-9368-a925b8e63671",
"name": "hs-metric-insight-api",
"toolName": "hengshi-regenerate-chat",
"toolId": "bc905914-81f5-45c2-b7f1-0c93ddbd71f7"
},
{
"id": "0192ca74-b1bc-4c6c-9368-a925b8e63671",
"name": "hs-metric-insight-api",
"toolName": "hengshi-search-chats",
"toolId": "417e651a-586d-4350-bff5-57797a944e26"
}
]
},
"serverRevision": "2026-10-19T16:05:07.516Z"
}