# AI 建模助手

<!-- BookStack import page: id=bm-ai chapter=业务建模中心 -->

## 功能定位

AI 建模助手根据业务描述和受控数据目录生成业务对象、指标、维度或模型候选草稿。AI 只生成候选，不直接写入正式字典或发布资产。

![AI 建模助手](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-eirvysxd.png)

*图 6-10　场景选择、范围限定与候选草稿*

## 适用角色

数据架构师、建模人员和业务分析专家。

## 页面入口

业务建模中心 → AI 建模助手（`/bi/bm/ai`）。

## 操作步骤

1. 选择可编辑的建模项目。
2. 选择生成场景，限定业务域、对象编码范围和来源表。
3. 用自然语言描述建模目标，例如“生成订单金额、订单数和客单价指标，说明口径并关联已有维度”。
4. 点击生成，查看草稿编号、候选数量、请求模型、实际模型、耗时和 Prompt 版本。
5. 打开草稿逐项检查；可接受单个候选项或接受全部通过校验的候选。
6. 拒绝不合适候选并填写原因；修订后重新校验。
7. 接受的候选仍进入业务字典草稿流程，必须提交审核后才能用于正式模型。

## 输入与输出

输入是项目、场景、来源表和业务需求；输出是结构化候选草稿、校验问题和接受/拒绝记录。

## 宏澜家电示例

输入“围绕销售订单生成成交金额、订单数、客单价和折扣率指标，关联时间、区域、渠道和产品维度”，AI 生成指标候选；建模人员修正“客单价”的取消订单规则后接受并提交审核。

## 安全边界

- 服务端对 AI 输入和输出做字段白名单与 SQL 安全检查。
- AI 不能读取未授权表，也不能绕过审核直接发布。
- 草稿中记录实际模型和 Prompt 版本，便于复现和审计。

## 客户应用演示：让 AI 起草“销售订单事实模型”

**业务情境：** 建模人员希望根据订单、客户和产品表快速生成模型草稿。

### 第一步：进入“业务建模中心 → AI建模助手”

![第1步重点操作：进入“业务建模中心 → AI建模助手”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-8dcmgsjl.jpeg)

*步骤图 32-01　第1步：进入“业务建模中心 → AI建模助手”。红框标出进入业务建模中心 → AI建模助手。*

进入“业务建模中心 → AI建模助手”，选择销售业务域和 1—3 张来源表。

### 第二步：输入“以订单明细为粒度

![第2步重点操作：输入“以订单明细为粒度](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-u71we1ua.jpeg)

*步骤图 32-02　第2步：输入“以订单明细为粒度。红框标出输入以订单明细为粒度。*

输入“以订单明细为粒度，生成销售事实模型，包含订单金额、数量、折扣额和毛利额”。

### 第三步：查看候选字段、主键、度量、维度和关系

![第3步重点操作：查看候选字段、主键、度量、维度和关系](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-utqzrwwc.jpeg)

*步骤图 32-03　第3步：查看候选字段、主键、度量、维度和关系。红框标出查看候选字段、主键、度量、维度和关系。*

查看候选字段、主键、度量、维度和关系，检查字段映射。

### 第四步：将草稿保存到当前项目

![第4步重点操作：将草稿保存到当前项目](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-xawhu0h4.jpeg)

*步骤图 32-04　第4步：将草稿保存到当前项目。红框标出将草稿保存到当前项目。*

将草稿保存到当前项目，并补充业务说明和负责人。

### 第五步：提交审核

![第5步重点操作：提交审核](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-2fcssvpg.jpeg)

*步骤图 32-05　第5步：提交审核。红框标出提交审核。*

提交审核；审核通过后再进入模型设计继续完善。

## 最终结果与效果

生成可编辑的模型草稿，字段和关系以结构化形式展示；草稿不会自动发布或执行。

> **操作提示：** 一次限定 1—3 张来源表能提高准确性；AI 生成的字段必须人工复核。

## 开发人员参考

- 接口：`/bi/bm/ai/status`、`/bi/bm/projects/{projectId}/ai/drafts`、`.../accept`、`.../reject`
- 权限：`bi:bm:ai:use`、`bi:bm:ai:accept`
- 输出经过结构校验和业务一致性校验；生成内容不自动执行。