AI功能总览
一、功能介绍
FastBee AI 是平台内置的智能助手能力，不只是一个聊天窗口。它把大模型、平台知识库、业务技能和文件产物生成串在一起，用于辅助用户完成平台使用咨询、智能问数、协议适配、物模型生成、需求评估等工作。
AI 回答和生成结果用于提高配置、分析和交付效率。涉及生产操作、协议上线、设备控制、数据查询和项目验收时，仍需要由有权限的人员复核确认。
二、启用前准备
使用 AI 功能前，建议先完成以下准备：
- 确认用户角色已分配AI赋能相关的菜单，管理端可以访问 AI 菜单。
- 配置至少一个可用的模型供应商和对话模型。
- 在 AI 对话中发送简单问题，确认模型可以正常返回。
- 如需平台问答、协议解析或智能问数，先创建并发布对应类型的知识库。
- 如需设备控制或数据查询，确认当前用户具备对应菜单、设备、产品和数据权限。
三、功能结构
四、主要功能
| 功能 | 用途 | 使用前提 |
|---|---|---|
| 模型供应商 | 维护大模型服务地址、鉴权方式、密钥和启用状态 | 已准备模型服务账号、API 地址和访问密钥 |
| 模型配置 | 维护模型编码、名称、类型、上下文长度和默认参数 | 已完成供应商配置 |
| AI 对话 | 用户提问、流式回复、会话记录、文件类能力入口 | 至少有一个启用的对话模型 |
| 平台助手 | 回答平台功能、菜单路径、配置步骤、使用说明等问题 | 建议发布平台文档知识库 |
| 智能问数 | 将自然语言转换为查询计划，查询关系库、实时数据、时序数据或混合数据 | 需要语义知识和数据权限 |
| 设备控制 | 辅助生成或执行设备控制相关指令 | 需要设备权限和业务开关支持 |
| 协议解析 | 基于协议资料抽取报文结构、字段、编解码规则和物模型映射 | 建议准备协议知识库和完整样例报文 |
| 协议适配 | 创建协议适配任务，生成 DSL、复核工作簿、代码包和测试报告 | 需要协议资料、模型和人工复核 |
| 物模型生成 | 从点位表、寄存器表、属性清单等文件生成物模型导入模板 | 需要上传结构清晰的文件 |
| 需求评估 | 根据需求文档评估平台匹配度、差距、风险和二开建议 | 需要上传需求说明或功能清单 |
| 知识库 | 管理平台文档、协议知识、NL2SQL 语义和源码导航知识 | 需要构建并发布知识版本 |
五、AI 对话模式
AI 对话支持自动识别和指定模式两种使用方式。普通用户优先使用“自动识别”，系统会根据问题意图选择合适能力；当用户明确知道要使用某类能力时，也可以在页面上切换或锁定模式。
| 模式 | 适合问题 | 典型输出 |
|---|---|---|
| 自动识别 | 不确定应该使用哪种能力 | 自动路由到平台助手、智能问数、协议解析等模式 |
| 平台助手 | 菜单在哪里、功能怎么用、配置步骤、源码导航类问题 | 操作说明、注意事项、相关入口 |
| 通用对话 | 与平台知识无关的通用问答、写作、解释 | 通用模型回答 |
| 智能问数 | 查询设备数量、在线状态、告警统计、实时值、历史趋势 | 查询计划、结构化结果或解释 |
| 设备控制 | 开关、重启、服务调用、场景执行等控制类请求 | 控制参数、执行结果或确认提示 |
| 协议解析 | 解析协议文件、报文、字段、编解码和接入规则 | 协议结构、字段表、风险问题 |
| 物模型生成 | 从点位表、寄存器表、设备说明生成物模型模板 | 可下载的物模型导入工作簿 |
| 需求评估 | 评估需求文档、招标文件、功能清单 | 匹配度、差距、风险、建议和报告 |
六、推荐使用顺序
首次启用 AI 时，建议按下面顺序验收：
- 配置模型供应商。
- 配置并启用模型，设置默认模型。
- 进入 AI 对话，验证普通问答可用。
- 创建平台文档知识库，下载模板、填写内容、上传解析。
- 构建并发布知识库版本，在平台助手中验证问答效果。
- 如需智能问数，维护 NL2SQL 语义知识并验证查询范围。
- 如需协议适配，维护协议知识库，再创建协议适配任务。
- 如需文件类能力，准备物模型点位表或需求文档，验证下载产物。
七、典型场景
1. 查询平台怎么使用
进入 AI 对话，选择“自动识别”或“平台助手”，直接提问，例如“设备接入流程怎么配置”“告警规则在哪里设置”。如果平台文档知识库已发布，AI 会优先基于知识库回答；没有命中资料时，会回退到通用回答。
2. 根据数据提问
进入支持智能问数的入口，询问设备、产品、告警、实时值、历史趋势等问题。系统会结合语义知识和当前用户的数据权限生成查询计划，避免直接让用户手写 SQL。
3. 适配设备协议
创建协议适配任务，上传协议文档或样例报文，执行 AI 解析和质量校验。校验通过后可导出工作簿人工复核，再生成代码包、清单和测试报告。
4. 生成物模型模板
在 AI 对话中上传点位表、寄存器表、属性清单或设备说明，选择物模型生成能力，AI 会整理属性、事件、功能和标识符，生成可下载的导入工作簿。
5. 评估项目需求
上传需求说明、招标文件或功能清单，使用需求评估能力，输出平台匹配度、缺口、风险点、二开建议和评估报告。
八、权限与安全
- API Key 和模型密钥只允许管理员维护，保存后不应在页面、截图或文档中公开。
- 知识库资料可能包含客户项目、设备协议、源码说明和业务数据，上传前应确认权限和脱敏要求。
- 智能问数必须遵守用户的数据权限，不能用 AI 绕过租户、部门、产品或设备范围限制。
- 设备控制类请求应保留确认、审计和权限校验，避免误操作生产设备。
- 协议适配、物模型生成和需求评估的 AI 输出需要人工复核，不能直接替代验收测试。