AI 对话分析

功能定位
AI 对话分析让业务用户用自然语言描述分析目标，由大模型结合受控数据集和 MCP 工具生成多图表看板方案。系统先给出方案，用户二次确认后才真正创建数据集、图表和看板。
图 4-4　输入问题、查看步骤并确认看板方案
适用角色
业务分析人员、经营管理人员和 BI 分析师。当前演示环境页面显示模型为 
DeepSeek-V4.1-Flash，由企业模型网关调用。
页面入口
数据探索中心 → AI 对话分析（
/bi/superset/ai）。
操作步骤
在输入框描述业务问题，建议同时写明分析对象、时间范围、对比维度和关注指标。
点击“开始分析”或按 
Ctrl + Enter。系统展示 AI 工具调用轨迹和看板方案。
检查方案中的数据范围、图表数量、字段、指标、筛选条件和单位。一次最多生成 5 张图表，并放入同一看板。
点击“确认创建看板”。方案只能消费一次，重复提交会提示过期或已执行。
创建完成后点击“打开看板”，在 Superset 中查看结果。
需要调整样式时，输入“把背景改成深蓝色”“图表使用青蓝色系”“标题字号调大”等指令，系统解析后应用到看板。
任何 AI 结果都必须人工复核后再用于经营判断。
推荐提问模板
分析【时间范围】内【业务对象】的【指标】，
按【维度一】和【维度二】拆分，
展示趋势、占比和排行，并标注异常。
宏澜家电示例：“分析最近 6 个月各区域销售额趋势、品类销售占比和前 10 名客户，使用青蓝色主题。”AI 返回趋势图、占比图、客户排行等多图表方案；确认后形成一个看板，再要求“标题字号调大、图表文字使用深灰色”。
输入与输出
项目
规则
问题长度
最多 500 字
分析边界
只读分析，不直接修改业务库
SQL 安全
数据集范围、字段白名单、只读和行数限制
方案确认
一次性消费，创建前必须人工确认
输出
一个最多 5 图表的看板、分析步骤和审计记录
客户应用演示：一次生成多图表销售复盘看板
业务情境： 经营会需要同时查看销售趋势、区域占比、品类结构和客户排行。
第一步：进入“数据探索中心 → AI 对话分析”
步骤图 20-01　第1步：进入“数据探索中心 → AI 对话分析”。红框标出进入数据探索中心 → AI 对话分析。
进入“数据探索中心 → AI 对话分析”，确认模型和 AI 状态可用。
第二步：输入“分析最近 6 个月销售额、毛利额和订单数
步骤图 20-02　第2步：输入“分析最近 6 个月销售额、毛利额和订单数。红框标出输入分析最近 6 个月销售额、毛利额和订单数。
输入“分析最近 6 个月销售额、毛利额和订单数，按月份看趋势、按区域和品类看占比，列出前 10 名客户”。
第三步：查看分析步骤
步骤图 20-03　第3步：查看分析步骤。红框标出查看分析步骤。
查看分析步骤，确认数据范围、指标口径和只读边界。
第四步：在看板方案中核对最多 5 张图表的类型、字段、筛选和单位
步骤图 20-04　第4步：在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。红框标出在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。
在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。
第五步：点击“确认创建看板”
步骤图 20-05　第5步：点击“确认创建看板”。红框标出点击确认创建看板。
点击“确认创建看板”，再点击“打开看板”查看结果。
第六步：输入“背景改为深蓝色
步骤图 20-06　第6步：输入“背景改为深蓝色。红框标出输入背景改为深蓝色。
输入“背景改为深蓝色，图表用青蓝色系，标题字号 18”，复核后保存。
最终结果与效果
同一看板生成趋势、占比、品类和客户排行等多张图表，配色和文字样式可按自然语言调整。方案需人工确认，不会自动发布。
操作提示： 方案约 30 分钟有效且只能消费一次；样式调整不改变底层数据。
常见问题
点击后没有生成看板。 检查是否已经点击二次确认；只有方案阶段不会创建资产。
提示方案已过期。 重新发起分析并生成新方案，不要重复使用旧方案。
样式指令没有生效。 使用明确的对象和值，例如“看板背景改为 #0B1F3A，图表标题字号 18”；若仍失败，检查看板 ID 和权限。
AI 回答看似合理但数据异常。 核对字段、时间范围、筛选条件和指标口径；AI 输出不能替代数据校验。
开发人员参考
页面：
ui/src/views/bi/ai/index.vue
接口：
GET /bi/ai/status、
POST /bi/ai/chat、
POST /bi/ai/execute、
POST /bi/ai/style
权限：
bi:sup:ai
方案包含 
planId 且一次性有效；服务端校验数据集范围、字段白名单、只读 SQL 和行数限制。
模型网关配置通过环境变量管理，文档和日志不得出现真实 API Key。