升鲜宝AI助手 E-R 图与操作说明书
适用对象：产品、研发、测试、实施、运维、业务管理员
一、文档说明
本说明书用于指导"升鲜宝供应链系统"中的一级功能菜单"AI助手"进行建设、理解和使用。文档包含两大部分：
• 第一部分：升鲜宝 AI 数据库表结构 E-R 关系说明。
• 第二部分：AI助手操作说明书，覆盖 9 个二级模块与 70 个三级功能页面。
系统定位：AI助手是升鲜宝供应链系统中的一个一级业务模块，不是独立系统。其核心目标是通过"指标标准化 + 预警自动化 + 报表智能化 + 预测决策化 + 知识库语义化 + 模型治理化"提升供应链经营分析能力。
二、AI 助手功能结构总览
一级菜单：AI助手
|--------|----------|------------|------------------------------------------------|
| 序号 | 二级模块 | 三级功能页面 | 页面作用 |
| 1 | 智能工作台 | AI经营驾驶舱 | 展示销售、采购、库存、毛利、预警等核心指标总览，并以卡片、图表、排行榜形式输出当日经营态势。 |
| 2 | 智能工作台 | 今日异常待办 | 集中查看今日需处理的缺货、临期、价格异常、损耗异常、任务失败等待办事项。 |
| 3 | 智能工作台 | AI智能问数 | 通过自然语言提问，自动生成安全 SQL、执行查询并输出图表与文字分析结论。 |
| 4 | 智能工作台 | AI经营日报 | 每天自动生成经营摘要，包含核心指标变化、异常提示和经营建议。 |
| 5 | 智能工作台 | AI预警概览 | 汇总预警中心触发的事件数量、等级、处理状态与处理时效。 |
| 6 | 智能工作台 | 常用问题收藏 | 沉淀高频问数问题与模板，便于一键复用。 |
| 7 | 智能工作台 | 我的订阅推送 | 查看个人已订阅的报表、预警与快报，以及最近推送结果。 |
| 8 | 经营分析 | 采购分析 | 分析采购金额、数量、单价波动、采购集中度、到货履约情况。 |
| 9 | 经营分析 | 销售订单分析 | 分析销售额、订单量、客单价、客户结构、取消率等。 |
| 10 | 经营分析 | 库存周转分析 | 分析库存金额、库龄、周转天数、库存结构与安全库存。 |
| 11 | 经营分析 | 缺货与滞销分析 | 识别缺货 SKU、滞销 SKU，并给出补货或清理建议。 |
| 12 | 经营分析 | 配送履约分析 | 分析配送准时率、签收时效、延迟、拒收与异常线路。 |
| 13 | 经营分析 | 财务毛利分析 | 分析毛利率、成本变化、费用分摊、客户/商品毛利异常。 |
| 14 | 经营分析 | 供应商履约分析 | 分析供应商到货、价格、质量、及时率与综合评分。 |
| 15 | 经营分析 | 质检溯源分析 | 分析质检结果、批次溯源、异常批次与风险追踪。 |
| 16 | 指标中心 | 指标分类 | 按业务域和层级管理指标分类目录。 |
| 17 | 指标中心 | 指标定义 | 维护指标编码、名称、统计周期、业务域、单位、维度等。 |
| 18 | 指标中心 | 指标口径维护 | 维护指标公式、统计规则、过滤条件与口径说明。 |
| 19 | 指标中心 | 指标取数SQL | 维护指标 SQL 版本、测试状态、发布状态与参数。 |
| 20 | 指标中心 | 指标快照 | 查看定时计算生成的指标结果快照。 |
| 21 | 指标中心 | 指标看板配置 | 配置驾驶舱和分析页中图表组件与看板布局。 |
| 22 | 指标中心 | 指标权限配置 | 配置不同角色可查看的指标范围。 |
| 23 | 预警中心 | 预警规则 | 配置预警规则、阈值逻辑、触发条件和作用范围。 |
| 24 | 预警中心 | 预警事件 | 查看已触发的所有预警事件并进行处理闭环。 |
| 25 | 预警中心 | 缺货预警 | 专门查看缺货类预警与补货建议。 |
| 26 | 预警中心 | 临期预警 | 专门查看临期商品预警与处置建议。 |
| 27 | 预警中心 | 采购价异常 | 监控采购价波动超阈值的事件。 |
| 28 | 预警中心 | 毛利异常 | 监控毛利率低于阈值或大幅波动的事件。 |
| 29 | 预警中心 | 损耗异常 | 监控报损率、损耗金额异常变化。 |
| 30 | 预警中心 | 推送策略 | 配置站内信、短信、企业微信、邮件等消息渠道和推送时间。 |
| 31 | 报表中心 | 报表模板 | 定义日报、周报、月报、专题报告的结构和内容。 |
| 32 | 报表中心 | AI日报 | 查看按日生成的 AI 分析报表。 |
| 33 | 报表中心 | AI周报 | 查看按周生成的 AI 分析报表。 |
| 34 | 报表中心 | AI月报 | 查看按月生成的 AI 分析报表。 |
| 35 | 报表中心 | 专项分析报告 | 针对专题场景生成的深度分析报告。 |
| 36 | 报表中心 | 报表任务 | 管理报表生成任务与调度状态。 |
| 37 | 报表中心 | 报表生成记录 | 查看已生成报表的历史记录与生成状态。 |
| 38 | 报表中心 | 报表导出下载 | 下载 PDF、Word、Excel 等报表产物。 |
| 39 | 预测决策 | 销量预测 | 预测未来销量趋势和关键 SKU 销量。 |
| 40 | 预测决策 | 补货建议 | 基于销量、库存、安全库存生成补货建议。 |
| 41 | 预测决策 | 库存优化 | 基于库存结构与周转结果给出优化建议。 |
| 42 | 预测决策 | 采购建议 | 结合销量预测、库存、供应商履约给出采购建议。 |
| 43 | 预测决策 | 调拨建议 | 结合门店/仓库库存差异给出调拨建议。 |
| 44 | 预测决策 | 供应商评分 | 生成供应商多维评分结果。 |
| 45 | 预测决策 | 经营建议闭环 | 汇总系统输出的经营建议，并跟踪处理状态。 |
| 46 | 预测决策 | 采纳效果评估 | 评估已采纳建议的后续效果。 |
| 47 | 知识库与语义 | 知识库管理 | 管理知识库主对象与业务域分类。 |
| 48 | 知识库与语义 | 文档管理 | 上传制度、SOP、报表解释、术语资料等文档。 |
| 49 | 知识库与语义 | 分段向量检索 | 查看与测试文档分段向量检索效果。 |
| 50 | 知识库与语义 | 业务术语库 | 维护供应链业务术语、同义词、别名。 |
| 51 | 知识库与语义 | 表字段语义 | 维护业务表字段的中文解释、语义标签和是否敏感。 |
| 52 | 知识库与语义 | 业务表映射 | 维护业务对象与源表、字段之间的映射关系。 |
| 53 | 知识库与语义 | 问数样例库 | 维护标准问数样例和推荐问法。 |
| 54 | 知识库与语义 | RAG检索测试 | 测试知识库召回、重排与引用效果。 |
| 55 | 模型配置 | API密钥配置 | 维护供应商 API Key、额度、失效时间和用途范围。 |
| 56 | 模型配置 | 大模型配置 | 维护模型清单、默认参数、上下文长度和成本。 |
| 57 | 模型配置 | 模型参数方案 | 按场景维护温度、top_p、输出长度等参数方案。 |
| 58 | 模型配置 | 助手角色配置 | 按业务场景配置助手角色和职责。 |
| 59 | 模型配置 | 提示词模板 | 维护系统提示词与场景提示词模板。 |
| 60 | 模型配置 | 工具函数配置 | 维护 AI 可调用的工具函数与接口能力。 |
| 61 | 模型配置 | 调用额度配置 | 维护调用配额、限流、成本控制。 |
| 62 | 模型配置 | 敏感词与脱敏 | 维护敏感词策略与输出脱敏规则。 |
| 63 | 审计与权限 | 模型调用日志 | 审计模型调用次数、耗时、成本和错误信息。 |
| 64 | 审计与权限 | 问数日志 | 审计自然语言问数请求与执行结果。 |
| 65 | 审计与权限 | 工具调用日志 | 记录工具函数调用情况。 |
| 66 | 审计与权限 | 生成SQL审计 | 审计 AI 生成 SQL 的安全性与执行情况。 |
| 67 | 审计与权限 | 成本与Token统计 | 统计模型调用成本、输入/输出 token 用量。 |
| 68 | 审计与权限 | 异常调用监控 | 监控调用失败、限流、超时、异常用量等。 |
| 69 | 审计与权限 | 菜单授权 | 配置 AI助手菜单与按钮权限。 |
| 70 | 审计与权限 | 多语言菜单维护 | 维护菜单国际化内容与多语言资源。 |
三、AI 数据库表结构总览
AI助手当前核心数据库共 29 张表，分为模型与会话、知识库与语义、指标与看板、预警与消息、报表与预测、审计与日志六大域。
|-------------------------|------------------------|
| 表名 | 用途说明 |
| ai_api_key | 外部模型供应商 API 密钥、额度与到期管理 |
| ai_model | 大模型清单与默认参数配置 |
| ai_prompt_template | 提示词模板及版本发布 |
| ai_chat_conversation | 会话主表 |
| ai_chat_message | 会话消息明细 |
| ai_knowledge | 知识库主表 |
| ai_knowledge_document | 知识库文档表 |
| ai_knowledge_segment | 知识分段/向量切片表 |
| ai_scm_data_asset | 供应链数据资产登记 |
| ai_scm_field_semantic | 字段语义与指标/维度/筛选属性 |
| ai_scm_business_mapping | 业务对象映射与语义映射 |
| ai_scm_metric_category | 指标分类 |
| ai_scm_metric | 指标定义 |
| ai_scm_metric_sql | 指标取数 SQL 版本 |
| ai_scm_metric_result | 指标计算结果/快照 |
| ai_scm_dashboard | 指标看板/驾驶舱布局配置 |
| ai_scm_report_template | 报表模板 |
| ai_scm_report_task | 报表生成任务 |
| ai_scm_warning_rule | 预警规则 |
| ai_scm_warning_event | 预警事件 |
| ai_scm_push_strategy | 消息推送策略 |
| ai_scm_message | 消息中心消息 |
| ai_scm_subscription | 用户订阅 |
| ai_scm_nlq_template | 问数样例/模板 |
| ai_scm_nlq_log | 智能问数执行日志 |
| ai_scm_forecast_result | 预测结果 |
| ai_scm_recommendation | 建议/闭环建议结果 |
| ai_scm_model_call_log | 模型调用日志 |
| ai_scm_operation_log | 操作审计日志 |
四、AI 数据库 E-R 图
以下 E-R 图以"逻辑关系"为主，用于说明表与表之间的业务关联和内在调用关系。
01_总览ER图
02_指标预警报表预测ER图
03_知识库语义问数ER图
04_模型配置与审计ER图
五、核心表关系说明
|------------------------|--------|------------------------|----------------------------|
| 主表 | 关系 | 从表 | 关系说明 |
| ai_api_key | 1:N | ai_model | 一个 API Key 可供多个模型配置复用 |
| ai_model | 1:N | ai_chat_message | 消息记录可标记实际使用的模型 |
| ai_model | 1:N | ai_knowledge | 知识库可绑定 embedding/rerank 模型 |
| ai_model | 1:N | ai_scm_nlq_log | 问数日志记录所用模型 |
| ai_model | 1:N | ai_scm_forecast_result | 预测结果记录模型来源 |
| ai_model | 1:N | ai_scm_model_call_log | 所有模型调用统一记录 |
| ai_prompt_template | 1:N | ai_scm_report_template | 报表模板可引用提示词模板 |
| ai_chat_conversation | 1:N | ai_chat_message | 一次会话下有多条消息 |
| ai_knowledge | 1:N | ai_knowledge_document | 一个知识库有多份文档 |
| ai_knowledge | 1:N | ai_knowledge_segment | 一个知识库有多条分段 |
| ai_knowledge_document | 1:N | ai_knowledge_segment | 一个文档会被切分成多个分段 |
| ai_scm_data_asset | 1:N | ai_scm_field_semantic | 一个数据资产下有多字段语义定义 |
| ai_scm_metric_category | 1:N | ai_scm_metric | 一个指标分类下有多个指标 |
| ai_scm_data_asset | 1:N | ai_scm_metric | 一个指标可指定来源数据资产 |
| ai_scm_metric | 1:N | ai_scm_metric_sql | 一个指标可有多个 SQL 版本 |
| ai_scm_metric | 1:N | ai_scm_metric_result | 一个指标产生多期结果 |
| ai_scm_metric | 1:N | ai_scm_warning_rule | 一个指标可绑定多条预警规则 |
| ai_scm_push_strategy | 1:N | ai_scm_warning_rule | 多个规则可复用同一推送策略 |
| ai_scm_warning_rule | 1:N | ai_scm_warning_event | 一条规则会产生多次事件 |
| ai_scm_warning_event | 1:N | ai_scm_recommendation | 一个事件可生成多条处理建议 |
| ai_scm_report_template | 1:N | ai_scm_report_task | 一个模板可派生多个报表任务 |
| ai_scm_subscription | N:1 | ai_scm_report_template | 订阅可指向报表模板或其他目标对象 |
| ai_scm_nlq_template | 1:N | ai_scm_nlq_log | 样例问题被使用后形成问数日志 |
六、模块之间的调用关系总说明
AI助手内部各模块并非孤立，而是形成了"业务数据 → 数据资产 → 指标 → 预警/报表/预测 → 建议 → 推送/审计"的完整闭环。
• 模型配置为所有 AI 能力提供底座，负责模型、API Key、Prompt、工具函数、额度和安全策略。
• 知识库与语义为 AI 问数、RAG 检索、术语解释和字段理解提供语义支撑。
• 指标中心是数据标准层，为经营分析、预警、报表和预测提供统一指标口径与结果。
• 预警中心消费指标结果和规则，触发预警事件并通过推送策略通知用户。
• 报表中心消费指标结果、预警事件和提示词模板，生成日报、周报、月报与专项报告。
• 预测决策模块消费历史指标、分析结果与模型能力，输出销量预测、补货建议、采购建议等结果。
• 审计与权限记录所有模型调用、问数、工具调用、SQL 生成与操作过程，保证可追溯。
典型调用链路示意：
• 业务源表（OMS/PUR/WMS/TMS/FIN/TRACE） → ai_scm_data_asset / ai_scm_field_semantic → ai_scm_metric / ai_scm_metric_sql → ai_scm_metric_result。
• ai_scm_metric_result → ai_scm_warning_rule → ai_scm_warning_event → ai_scm_push_strategy / ai_scm_message。
• ai_scm_metric_result + ai_prompt_template → ai_scm_report_template → ai_scm_report_task → 报表文件。
• ai_scm_metric_result + 历史经营数据 + ai_model → ai_scm_forecast_result → ai_scm_recommendation。
• ai_knowledge / ai_knowledge_document / ai_knowledge_segment + ai_scm_data_asset / ai_scm_field_semantic → AI智能问数 / RAG检索测试。
七、各二级模块作用与操作说明
7.1 智能工作台
AI助手的统一入口，承接驾驶舱总览、待办、问数、日报、预警概览与个人订阅内容，是日常高频使用的首页工作区。
|------------|------------------------------------------------|-----------------------------------------------------|
| 三级功能页面 | 功能作用 | 主要操作步骤 |
| AI经营驾驶舱 | 展示销售、采购、库存、毛利、预警等核心指标总览，并以卡片、图表、排行榜形式输出当日经营态势。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 今日异常待办 | 集中查看今日需处理的缺货、临期、价格异常、损耗异常、任务失败等待办事项。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| AI智能问数 | 通过自然语言提问，自动生成安全 SQL、执行查询并输出图表与文字分析结论。 | 输入问题/检索词 → 系统生成结果 → 查看明细 → 验证引用或 SQL → 收藏/保存。 |
| AI经营日报 | 每天自动生成经营摘要，包含核心指标变化、异常提示和经营建议。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| AI预警概览 | 汇总预警中心触发的事件数量、等级、处理状态与处理时效。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 常用问题收藏 | 沉淀高频问数问题与模板，便于一键复用。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 我的订阅推送 | 查看个人已订阅的报表、预警与快报，以及最近推送结果。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
7.2 经营分析
围绕采购、销售、库存、配送、财务、供应商与质检溯源等业务场景提供多维经营分析，所有分析结果可作为预警、报表与预测决策的上游输入。
|------------|------------------------------|-----------------------------------------------------|
| 三级功能页面 | 功能作用 | 主要操作步骤 |
| 采购分析 | 分析采购金额、数量、单价波动、采购集中度、到货履约情况。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 销售订单分析 | 分析销售额、订单量、客单价、客户结构、取消率等。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 库存周转分析 | 分析库存金额、库龄、周转天数、库存结构与安全库存。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 缺货与滞销分析 | 识别缺货 SKU、滞销 SKU，并给出补货或清理建议。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 配送履约分析 | 分析配送准时率、签收时效、延迟、拒收与异常线路。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 财务毛利分析 | 分析毛利率、成本变化、费用分摊、客户/商品毛利异常。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 供应商履约分析 | 分析供应商到货、价格、质量、及时率与综合评分。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 质检溯源分析 | 分析质检结果、批次溯源、异常批次与风险追踪。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
7.3 指标中心
负责指标的全生命周期管理，包括分类、定义、口径、取数SQL、快照结果、看板配置与权限配置，是 AI 问数、预警、报表、预测的统一数据标准层。
|------------|----------------------------|-----------------------------------------------------|
| 三级功能页面 | 功能作用 | 主要操作步骤 |
| 指标分类 | 按业务域和层级管理指标分类目录。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 指标定义 | 维护指标编码、名称、统计周期、业务域、单位、维度等。 | 新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。 |
| 指标口径维护 | 维护指标公式、统计规则、过滤条件与口径说明。 | 新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。 |
| 指标取数SQL | 维护指标 SQL 版本、测试状态、发布状态与参数。 | 新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。 |
| 指标快照 | 查看定时计算生成的指标结果快照。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 指标看板配置 | 配置驾驶舱和分析页中图表组件与看板布局。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 指标权限配置 | 配置不同角色可查看的指标范围。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
7.4 预警中心
负责预警规则定义、事件触发、主题预警、推送策略与闭环处理，是异常识别与提醒的核心控制台。
|------------|-----------------------------|-----------------------------------------------------|
| 三级功能页面 | 功能作用 | 主要操作步骤 |
| 预警规则 | 配置预警规则、阈值逻辑、触发条件和作用范围。 | 新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。 |
| 预警事件 | 查看已触发的所有预警事件并进行处理闭环。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 缺货预警 | 专门查看缺货类预警与补货建议。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 临期预警 | 专门查看临期商品预警与处置建议。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 采购价异常 | 监控采购价波动超阈值的事件。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 毛利异常 | 监控毛利率低于阈值或大幅波动的事件。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 损耗异常 | 监控报损率、损耗金额异常变化。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 推送策略 | 配置站内信、短信、企业微信、邮件等消息渠道和推送时间。 | 新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。 |
7.5 报表中心
负责 AI 日报、周报、月报、专项报告模板与任务生成，并向导出下载、订阅推送等能力输出标准化结果。
|------------|--------------------------|-----------------------------------------|
| 三级功能页面 | 功能作用 | 主要操作步骤 |
| 报表模板 | 定义日报、周报、月报、专题报告的结构和内容。 | 新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。 |
| AI日报 | 查看按日生成的 AI 分析报表。 | 选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。 |
| AI周报 | 查看按周生成的 AI 分析报表。 | 选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。 |
| AI月报 | 查看按月生成的 AI 分析报表。 | 选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。 |
| 专项分析报告 | 针对专题场景生成的深度分析报告。 | 选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。 |
| 报表任务 | 管理报表生成任务与调度状态。 | 选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。 |
| 报表生成记录 | 查看已生成报表的历史记录与生成状态。 | 选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。 |
| 报表导出下载 | 下载 PDF、Word、Excel 等报表产物。 | 选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。 |
7.6 预测决策
基于指标、历史经营数据与模型能力生成销量预测、补货建议、库存优化、采购建议等建议结果，并形成建议闭环与采纳评估。
|------------|------------------------|-----------------------------------------------------|
| 三级功能页面 | 功能作用 | 主要操作步骤 |
| 销量预测 | 预测未来销量趋势和关键 SKU 销量。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 补货建议 | 基于销量、库存、安全库存生成补货建议。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 库存优化 | 基于库存结构与周转结果给出优化建议。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 采购建议 | 结合销量预测、库存、供应商履约给出采购建议。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 调拨建议 | 结合门店/仓库库存差异给出调拨建议。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 供应商评分 | 生成供应商多维评分结果。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 经营建议闭环 | 汇总系统输出的经营建议，并跟踪处理状态。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 采纳效果评估 | 评估已采纳建议的后续效果。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
7.7 知识库与语义
为问数、RAG 检索、术语解释、表字段语义理解提供底层知识能力，是 AI 理解业务语言和数据对象的关键基础设施。
|------------|-------------------------|-----------------------------------------------------|
| 三级功能页面 | 功能作用 | 主要操作步骤 |
| 知识库管理 | 管理知识库主对象与业务域分类。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 文档管理 | 上传制度、SOP、报表解释、术语资料等文档。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 分段向量检索 | 查看与测试文档分段向量检索效果。 | 输入问题/检索词 → 系统生成结果 → 查看明细 → 验证引用或 SQL → 收藏/保存。 |
| 业务术语库 | 维护供应链业务术语、同义词、别名。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 表字段语义 | 维护业务表字段的中文解释、语义标签和是否敏感。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 业务表映射 | 维护业务对象与源表、字段之间的映射关系。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 问数样例库 | 维护标准问数样例和推荐问法。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| RAG检索测试 | 测试知识库召回、重排与引用效果。 | 输入问题/检索词 → 系统生成结果 → 查看明细 → 验证引用或 SQL → 收藏/保存。 |
7.8 模型配置
配置 API 密钥、大模型、模型参数、角色、提示词、工具函数、额度与敏感词，决定 AI 能力的可用范围、成本与安全边界。
|------------|-----------------------------|-----------------------------------------------------|
| 三级功能页面 | 功能作用 | 主要操作步骤 |
| API密钥配置 | 维护供应商 API Key、额度、失效时间和用途范围。 | 新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。 |
| 大模型配置 | 维护模型清单、默认参数、上下文长度和成本。 | 新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。 |
| 模型参数方案 | 按场景维护温度、top_p、输出长度等参数方案。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 助手角色配置 | 按业务场景配置助手角色和职责。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 提示词模板 | 维护系统提示词与场景提示词模板。 | 新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。 |
| 工具函数配置 | 维护 AI 可调用的工具函数与接口能力。 | 新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。 |
| 调用额度配置 | 维护调用配额、限流、成本控制。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
| 敏感词与脱敏 | 维护敏感词策略与输出脱敏规则。 | 进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。 |
7.9 审计与权限
负责模型调用、问数、工具调用、SQL 审计、成本统计、异常监控与菜单授权，保障系统的可追溯、安全和合规。
|------------|--------------------------|----------------------------------------|
| 三级功能页面 | 功能作用 | 主要操作步骤 |
| 模型调用日志 | 审计模型调用次数、耗时、成本和错误信息。 | 查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。 |
| 问数日志 | 审计自然语言问数请求与执行结果。 | 查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。 |
| 工具调用日志 | 记录工具函数调用情况。 | 查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。 |
| 生成SQL审计 | 审计 AI 生成 SQL 的安全性与执行情况。 | 查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。 |
| 成本与Token统计 | 统计模型调用成本、输入/输出 token 用量。 | 查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。 |
| 异常调用监控 | 监控调用失败、限流、超时、异常用量等。 | 查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。 |
八、AI 助手操作说明书（按业务流程）
8.1 指标建设流程
• 步骤1：进入"指标分类"，建立采购、销售、库存、配送、财务、供应商、质检等分类目录。
• 步骤2：进入"指标定义"，新增指标编码、名称、统计周期、业务域、单位和维度信息。
• 步骤3：进入"指标口径维护"，补充公式说明、过滤条件、口径备注。
• 步骤4：进入"指标取数SQL"，编写或维护取数 SQL，进行测试并发布。
• 步骤5：进入"指标快照"，查看定时任务计算出的指标结果。
• 步骤6：进入"指标看板配置"，将关键指标发布到驾驶舱和分析页面。
• 步骤7：进入"指标权限配置"，限制不同角色可查看的指标范围。
8.2 预警建设与处理流程
• 步骤1：进入"预警规则"，选择对应指标，定义触发条件、阈值、作用范围和预警等级。
• 步骤2：进入"推送策略"，配置通知渠道、接收人、触发时机和静默时间。
• 步骤3：系统按规则扫描指标结果，触发后写入"预警事件"。
• 步骤4：业务人员进入"预警事件"或主题预警页面（缺货预警、临期预警、采购价异常、毛利异常、损耗异常）查看详情。
• 步骤5：处理人录入处理结果、原因、措施，形成闭环。
8.3 报表生成流程
• 步骤1：进入"报表模板"，定义日报/周报/月报/专项报告结构、章节、指标清单和提示词。
• 步骤2：进入"报表任务"，手工或定时下发生成任务。
• 步骤3：系统生成后在"报表生成记录"中保留结果。
• 步骤4：进入"报表导出下载"，下载 Word/PDF/Excel 等结果文件。
• 步骤5：如需自动触达，可配合"我的订阅推送"和"推送策略"进行消息发送。
8.4 智能问数与知识库流程
• 步骤1：先在"知识库管理、文档管理、业务术语库、表字段语义、业务表映射、问数样例库"中准备知识与语义基础。
• 步骤2：进入"AI智能问数"输入自然语言问题，例如"本周毛利异常的商品有哪些？"。
• 步骤3：系统结合字段语义、样例模板、业务表映射生成安全 SQL，并记录到"问数日志"和"生成SQL审计"。
• 步骤4：系统执行查询并输出图表、表格和文字分析。
• 步骤5：如需验证检索效果，可进入"RAG检索测试"和"分段向量检索"。
8.5 预测与建议流程
• 步骤1：进入"销量预测"，生成未来期间销量预测结果。
• 步骤2：系统结合库存现状，自动在"补货建议、库存优化、采购建议、调拨建议"中输出建议内容。
• 步骤3：系统可根据采购、配送、质量等历史表现生成"供应商评分"。
• 步骤4：所有建议统一汇总到"经营建议闭环"，并在"采纳效果评估"中跟踪采纳前后效果。
8.6 模型配置与治理流程
• 步骤1：进入"API密钥配置"，维护各模型供应商 API Key 和额度信息。
• 步骤2：进入"大模型配置"和"模型参数方案"，维护模型清单、默认参数和场景参数。
• 步骤3：进入"助手角色配置"和"提示词模板"，定义不同业务场景下的角色与提示词。
• 步骤4：进入"工具函数配置"，给模型开放可调用的后端工具函数。
• 步骤5：进入"调用额度配置""敏感词与脱敏"，设置成本控制和输出安全规则。
九、各三级页面的上游输入、核心处理、输出去向
|--------|------------|--------------------|---------------------|--------------------------|
| 序号 | 三级功能 | 上游输入 | 核心处理 | 输出去向 |
| 1 | AI经营驾驶舱 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 2 | 今日异常待办 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 3 | AI智能问数 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 4 | AI经营日报 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 5 | AI预警概览 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 6 | 常用问题收藏 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 7 | 我的订阅推送 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 8 | 采购分析 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 9 | 销售订单分析 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 10 | 库存周转分析 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 11 | 缺货与滞销分析 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 12 | 配送履约分析 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 13 | 财务毛利分析 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 14 | 供应商履约分析 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 15 | 质检溯源分析 | 业务源数据 / 配置表 / 用户输入 | 查询、计算、分析、生成、推送、记录 | 页面展示 / 报表 / 预警 / 建议 / 日志 |
| 16 | 指标分类 | 数据资产、字段语义、业务表 | 定义指标、维护SQL、计算快照 | 分析页、预警、报表、预测 |
| 17 | 指标定义 | 数据资产、字段语义、业务表 | 定义指标、维护SQL、计算快照 | 分析页、预警、报表、预测 |
| 18 | 指标口径维护 | 数据资产、字段语义、业务表 | 定义指标、维护SQL、计算快照 | 分析页、预警、报表、预测 |
| 19 | 指标取数SQL | 数据资产、字段语义、业务表 | 定义指标、维护SQL、计算快照 | 分析页、预警、报表、预测 |
| 20 | 指标快照 | 数据资产、字段语义、业务表 | 定义指标、维护SQL、计算快照 | 分析页、预警、报表、预测 |
| 21 | 指标看板配置 | 数据资产、字段语义、业务表 | 定义指标、维护SQL、计算快照 | 分析页、预警、报表、预测 |
| 22 | 指标权限配置 | 数据资产、字段语义、业务表 | 定义指标、维护SQL、计算快照 | 分析页、预警、报表、预测 |
| 23 | 预警规则 | 指标结果、规则配置、推送策略 | 规则判断、事件生成、消息推送、闭环处理 | 消息中心、工作台、报表、建议 |
| 24 | 预警事件 | 指标结果、规则配置、推送策略 | 规则判断、事件生成、消息推送、闭环处理 | 消息中心、工作台、报表、建议 |
| 25 | 缺货预警 | 指标结果、规则配置、推送策略 | 规则判断、事件生成、消息推送、闭环处理 | 消息中心、工作台、报表、建议 |
| 26 | 临期预警 | 指标结果、规则配置、推送策略 | 规则判断、事件生成、消息推送、闭环处理 | 消息中心、工作台、报表、建议 |
| 27 | 采购价异常 | 指标结果、规则配置、推送策略 | 规则判断、事件生成、消息推送、闭环处理 | 消息中心、工作台、报表、建议 |
| 28 | 毛利异常 | 指标结果、规则配置、推送策略 | 规则判断、事件生成、消息推送、闭环处理 | 消息中心、工作台、报表、建议 |
| 29 | 损耗异常 | 指标结果、规则配置、推送策略 | 规则判断、事件生成、消息推送、闭环处理 | 消息中心、工作台、报表、建议 |
| 30 | 推送策略 | 指标结果、规则配置、推送策略 | 规则判断、事件生成、消息推送、闭环处理 | 消息中心、工作台、报表、建议 |
| 31 | 报表模板 | 指标结果、预警事件、提示词模板 | 模板渲染、AI生成、任务调度、导出 | 文件下载、订阅推送、操作留痕 |
| 32 | AI日报 | 指标结果、预警事件、提示词模板 | 模板渲染、AI生成、任务调度、导出 | 文件下载、订阅推送、操作留痕 |
| 33 | AI周报 | 指标结果、预警事件、提示词模板 | 模板渲染、AI生成、任务调度、导出 | 文件下载、订阅推送、操作留痕 |
| 34 | AI月报 | 指标结果、预警事件、提示词模板 | 模板渲染、AI生成、任务调度、导出 | 文件下载、订阅推送、操作留痕 |
| 35 | 专项分析报告 | 指标结果、预警事件、提示词模板 | 模板渲染、AI生成、任务调度、导出 | 文件下载、订阅推送、操作留痕 |
| 36 | 报表任务 | 指标结果、预警事件、提示词模板 | 模板渲染、AI生成、任务调度、导出 | 文件下载、订阅推送、操作留痕 |
| 37 | 报表生成记录 | 指标结果、预警事件、提示词模板 | 模板渲染、AI生成、任务调度、导出 | 文件下载、订阅推送、操作留痕 |
| 38 | 报表导出下载 | 指标结果、预警事件、提示词模板 | 模板渲染、AI生成、任务调度、导出 | 文件下载、订阅推送、操作留痕 |
| 39 | 销量预测 | 历史指标、库存、销量、模型参数 | 预测、推荐、评估 | 建议闭环、采纳评估、报表 |
| 40 | 补货建议 | 历史指标、库存、销量、模型参数 | 预测、推荐、评估 | 建议闭环、采纳评估、报表 |
| 41 | 库存优化 | 历史指标、库存、销量、模型参数 | 预测、推荐、评估 | 建议闭环、采纳评估、报表 |
| 42 | 采购建议 | 历史指标、库存、销量、模型参数 | 预测、推荐、评估 | 建议闭环、采纳评估、报表 |
| 43 | 调拨建议 | 历史指标、库存、销量、模型参数 | 预测、推荐、评估 | 建议闭环、采纳评估、报表 |
| 44 | 供应商评分 | 历史指标、库存、销量、模型参数 | 预测、推荐、评估 | 建议闭环、采纳评估、报表 |
| 45 | 经营建议闭环 | 历史指标、库存、销量、模型参数 | 预测、推荐、评估 | 建议闭环、采纳评估、报表 |
| 46 | 采纳效果评估 | 历史指标、库存、销量、模型参数 | 预测、推荐、评估 | 建议闭环、采纳评估、报表 |
| 47 | 知识库管理 | 文档、术语、表字段、样例问题 | 切分、向量化、语义映射、检索 | 问数、RAG、解释说明 |
| 48 | 文档管理 | 文档、术语、表字段、样例问题 | 切分、向量化、语义映射、检索 | 问数、RAG、解释说明 |
| 49 | 分段向量检索 | 文档、术语、表字段、样例问题 | 切分、向量化、语义映射、检索 | 问数、RAG、解释说明 |
| 50 | 业务术语库 | 文档、术语、表字段、样例问题 | 切分、向量化、语义映射、检索 | 问数、RAG、解释说明 |
| 51 | 表字段语义 | 文档、术语、表字段、样例问题 | 切分、向量化、语义映射、检索 | 问数、RAG、解释说明 |
| 52 | 业务表映射 | 文档、术语、表字段、样例问题 | 切分、向量化、语义映射、检索 | 问数、RAG、解释说明 |
| 53 | 问数样例库 | 文档、术语、表字段、样例问题 | 切分、向量化、语义映射、检索 | 问数、RAG、解释说明 |
| 54 | RAG检索测试 | 文档、术语、表字段、样例问题 | 切分、向量化、语义映射、检索 | 问数、RAG、解释说明 |
| 55 | API密钥配置 | 供应商配置、模型能力、提示词 | 参数管理、成本控制、安全脱敏 | 所有 AI 调用场景 |
| 56 | 大模型配置 | 供应商配置、模型能力、提示词 | 参数管理、成本控制、安全脱敏 | 所有 AI 调用场景 |
| 57 | 模型参数方案 | 供应商配置、模型能力、提示词 | 参数管理、成本控制、安全脱敏 | 所有 AI 调用场景 |
| 58 | 助手角色配置 | 供应商配置、模型能力、提示词 | 参数管理、成本控制、安全脱敏 | 所有 AI 调用场景 |
| 59 | 提示词模板 | 供应商配置、模型能力、提示词 | 参数管理、成本控制、安全脱敏 | 所有 AI 调用场景 |
| 60 | 工具函数配置 | 供应商配置、模型能力、提示词 | 参数管理、成本控制、安全脱敏 | 所有 AI 调用场景 |
| 61 | 调用额度配置 | 供应商配置、模型能力、提示词 | 参数管理、成本控制、安全脱敏 | 所有 AI 调用场景 |
| 62 | 敏感词与脱敏 | 供应商配置、模型能力、提示词 | 参数管理、成本控制、安全脱敏 | 所有 AI 调用场景 |
| 63 | 模型调用日志 | 调用行为、SQL、操作行为 | 审计、监控、统计、授权 | 风控治理、问题排查、合规 |
| 64 | 问数日志 | 调用行为、SQL、操作行为 | 审计、监控、统计、授权 | 风控治理、问题排查、合规 |
| 65 | 工具调用日志 | 调用行为、SQL、操作行为 | 审计、监控、统计、授权 | 风控治理、问题排查、合规 |
| 66 | 生成SQL审计 | 调用行为、SQL、操作行为 | 审计、监控、统计、授权 | 风控治理、问题排查、合规 |
| 67 | 成本与Token统计 | 调用行为、SQL、操作行为 | 审计、监控、统计、授权 | 风控治理、问题排查、合规 |
| 68 | 异常调用监控 | 调用行为、SQL、操作行为 | 审计、监控、统计、授权 | 风控治理、问题排查、合规 |
十、角色与权限建议
• 系统管理员：负责模型配置、菜单授权、多语言维护、所有日志审计。
• AI运营管理员：负责指标、预警、报表、知识库、样例库、提示词模板运营。
• 业务分析员：负责经营分析、问数、驾驶舱、报表查看与专题分析。
• 采购/库存/财务/配送负责人：重点使用相关分析页、预警页和建议页。
• 普通业务用户：查看与自身权限相关的驾驶舱、消息、日报、订阅内容。
十一、安全与审计要求
• 自然语言问数生成的 SQL 必须只允许 SELECT，只能查询授权表，且必须进行行数限制。
• 所有模型调用必须写入 ai_scm_model_call_log，并记录模型、场景、耗时、token 和成本。
• 所有关键操作必须写入 ai_scm_operation_log，包括新增/修改/删除/发布/启停。
• AI 输出内容需经过敏感词与脱敏策略过滤，防止泄露客户、价格、财务等敏感信息。
• 消息推送需遵守静默时段、订阅状态和接收范围控制，避免骚扰式通知。
十二、实施与上线建议
• 建议先建设：模型配置、指标中心、预警中心、报表中心、知识库与语义。
• 第二阶段建设：经营分析、AI智能问数、预测决策。
• 第三阶段完善：成本审计、异常监控、多语言维护、建议闭环与效果评估。
• 上线前需完成：权限联调、数据源联调、指标口径确认、SQL 安全测试、模型成本压测、推送通道测试。
十三、附件
附件一：AI 数据库 E-R 图（已嵌入文档，共 4 张）。
附件二：AI 核心表清单（29 张）。
附件三：AI 助手 9 大模块 / 70 个三级功能页面说明。