# AI 对话分析

<!-- BookStack import page: id=ai-chat chapter=数据探索中心 -->

## 功能定位

AI 对话分析让业务用户用自然语言描述分析目标，由大模型结合受控数据集和 MCP 工具生成多图表看板方案。系统先给出方案，用户二次确认后才真正创建数据集、图表和看板。

![AI 对话分析](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-wqqj4qay.png)

*图 4-4　输入问题、查看步骤并确认看板方案*

## 适用角色

业务分析人员、经营管理人员和 BI 分析师。当前演示环境页面显示模型为 `DeepSeek-V4.1-Flash`，由企业模型网关调用。

## 页面入口

数据探索中心 → AI 对话分析（`/bi/superset/ai`）。

## 操作步骤

1. 在输入框描述业务问题，建议同时写明**分析对象、时间范围、对比维度和关注指标**。
2. 点击“开始分析”或按 `Ctrl + Enter`。系统展示 AI 工具调用轨迹和看板方案。
3. 检查方案中的数据范围、图表数量、字段、指标、筛选条件和单位。一次最多生成 5 张图表，并放入同一看板。
4. 点击“确认创建看板”。方案只能消费一次，重复提交会提示过期或已执行。
5. 创建完成后点击“打开看板”，在 Superset 中查看结果。
6. 需要调整样式时，输入“把背景改成深蓝色”“图表使用青蓝色系”“标题字号调大”等指令，系统解析后应用到看板。
7. 任何 AI 结果都必须人工复核后再用于经营判断。

## 推荐提问模板

```text
分析【时间范围】内【业务对象】的【指标】，
按【维度一】和【维度二】拆分，
展示趋势、占比和排行，并标注异常。
```

**宏澜家电示例：**“分析最近 6 个月各区域销售额趋势、品类销售占比和前 10 名客户，使用青蓝色主题。”AI 返回趋势图、占比图、客户排行等多图表方案；确认后形成一个看板，再要求“标题字号调大、图表文字使用深灰色”。

## 输入与输出

| 项目 | 规则 |
|---|---|
| 问题长度 | 最多 500 字 |
| 分析边界 | 只读分析，不直接修改业务库 |
| SQL 安全 | 数据集范围、字段白名单、只读和行数限制 |
| 方案确认 | 一次性消费，创建前必须人工确认 |
| 输出 | 一个最多 5 图表的看板、分析步骤和审计记录 |

## 客户应用演示：一次生成多图表销售复盘看板

**业务情境：** 经营会需要同时查看销售趋势、区域占比、品类结构和客户排行。

### 第一步：进入“数据探索中心 → AI 对话分析”

![第1步重点操作：进入“数据探索中心 → AI 对话分析”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-wujvxlrh.jpeg)

*步骤图 20-01　第1步：进入“数据探索中心 → AI 对话分析”。红框标出进入数据探索中心 → AI 对话分析。*

进入“数据探索中心 → AI 对话分析”，确认模型和 AI 状态可用。

### 第二步：输入“分析最近 6 个月销售额、毛利额和订单数

![第2步重点操作：输入“分析最近 6 个月销售额、毛利额和订单数](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-vyxrqj6x.jpeg)

*步骤图 20-02　第2步：输入“分析最近 6 个月销售额、毛利额和订单数。红框标出输入分析最近 6 个月销售额、毛利额和订单数。*

输入“分析最近 6 个月销售额、毛利额和订单数，按月份看趋势、按区域和品类看占比，列出前 10 名客户”。

### 第三步：查看分析步骤

![第3步重点操作：查看分析步骤](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-3dfqdofk.jpeg)

*步骤图 20-03　第3步：查看分析步骤。红框标出查看分析步骤。*

查看分析步骤，确认数据范围、指标口径和只读边界。

### 第四步：在看板方案中核对最多 5 张图表的类型、字段、筛选和单位

![第4步重点操作：在看板方案中核对最多 5 张图表的类型、字段、筛选和单位](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-xehqqc0f.jpeg)

*步骤图 20-04　第4步：在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。红框标出在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。*

在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。

### 第五步：点击“确认创建看板”

![第5步重点操作：点击“确认创建看板”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-2auwhdtg.jpeg)

*步骤图 20-05　第5步：点击“确认创建看板”。红框标出点击确认创建看板。*

点击“确认创建看板”，再点击“打开看板”查看结果。

### 第六步：输入“背景改为深蓝色

![第6步重点操作：输入“背景改为深蓝色](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-mtlc9lqw.jpeg)

*步骤图 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。