主题
AI引擎底座 · 概要设计
文档版本：3.10 ｜ 最近核对日期：2026-11-10
1. 架构现状与目标
业务范围见需求分析。2026-11-10 需求方确认平台 AI 能力分为智办、智审、智控、智管四类；本文记录四类能力的目标架构、责任边界和演进原则。当前已实施的只有智办首期（工程基础试点），链路已通过技术验证（见测试与验收）；智审本期不实施，智管尚未设计实施，智控由佳都实施，均不能按本文表述为已上线。
| 层次 | 智办首期实施状态（2026-11-10） |
|---|---|
| Vue | 单例悬浮助手已挂载（App.vue）；模块识别经 route.meta.aiModuleKey；iframe 承载与整页会话复用同一组件 |
| admin | 凭证校验器、路 B MCP 服务（两个业务工具）、委托验证过滤器已实现 |
| SnailAI | 工程基础智能体及知识库已建（批次 batch-20261110-01）；会话归属校验与路 B 委托签发扩展已部署 |
| 路 A | mcp-public 独立服务已实现：3 对象准入目录 + SQL 白名单 + 只读账号 |
| 路 B | 已实现：动作权限复用 + EngineeringDataAccessHelper 范围判定 + 短期委托主体 |
现有会话不是平台原生消息组件；前端目录只有注册包装 API，但依赖包内部已有会话网关，不能据此重复建设整套聊天服务。
工程基础智能体直接在SnailAI现有控制台创建，复用其提示词、模型绑定、知识库绑定、MCP挂接、编排、会话与记忆，不另建智能体引擎或市场。平台仅提供入口、模块映射和可信业务工具。
2. 四能力产品架构（目标）
2.1 分层与关系
四类能力共用同一 AI 底座，不为单个能力另建聊天、知识库、模型或工具平台。智办提供读取和解释，智审提供审批辅助，智管提供受控写入编排，智控是第三方能力，只通过数据/接口契约协作。
2.2 能力与集成点
| 能力 | 入口 | 复用底座 | 新增集成 | 当前状态 |
|---|---|---|---|---|
| 智办 | 全局悬浮助手、整页会话 | 身份/会话、RAG、路 A/路 B、内容过滤、审计 | 页面模块映射、环境 agentId | 工程基础试点已实施 |
| 智审 | 审批页/流程工作台的辅助面板 | 身份/会话、模块知识、授权数据查询、审计 | 当前任务与节点、表单、附件、流程历史、前序意见；建议与反馈留痕 | 本期不实施；审批场景待业务部门确认 |
| 智管 | 运维/管理入口的自然语言编排 | 身份/会话、审计、权限校验 | 用户/角色/组织/数据范围/流程定义服务；专用读写 MCP（候选）；影响预览；确认/审批；回读/回退 | 未实施 |
| 智控 | 佳都系统 | 平台数据与接口 | 数据/接口网关、业务拆解、口径说明、受控访问、SLA；进度滞后、手续附件/条件缺失、审批/履约风险等预警场景 | 佳都实施，平台配合；本模块不实施 |
智审和智管需要的动作工具与智办的只读查询分开设计：查询工具不改变业务记录；动作工具必须校验发起人权限、限制目标和范围、要求确认或审批、执行后回读并留痕。不能把自然语言或模型参数当作授权依据。
2.3 能力责任边界
| 边界 | 平台 AI 引擎 | 业务模块 | 流程/运维服务 | 第三方 |
|---|---|---|---|---|
| 智办 | 入口、会话、知识、只读工具、来源解释 | 业务规则与数据权限 | 不涉及 | 不涉及 |
| 智审 | 上下文接入、审查建议、依据引用、审计 | 节点语义、材料要求、规则来源 | Warm-Flow 提供任务/表单/附件/历史；不改变流程语义 | 不涉及 |
| 智管 | 意图解析、影响预览、编排、确认/审批、动作执行与回读 | 业务规则与数据权限 | 用户/角色/组织/数据范围/流程定义服务执行实际变更 | 不涉及 |
| 智控 | 数据/接口、业务拆解、受控访问 | 数据口径与权限 | 提供必要状态/配置接口 | 佳都负责监控分析、风险预警、页面与集成 |
| 智管专用读写 MCP（候选） | 按业务语义封装的受控读写、权限校验、事务、回读、审计 | 提供业务规则与目标数据 | 既有服务优先；MCP 只覆盖服务无法承载的受控动作 | 不涉及 |
平台 AI 不定义业务规则，不代替审批人，不直接修改业务库；智管的写操作必须经既有服务或按业务语义封装的专用读写 MCP，并校验权限、事务、回读和审计。业务模块不能把规则定义权交给模型；流程/运维服务保留实际变更和审批责任；第三方不得直连生产库或绕过平台权限。
2.4 演进原则
- 复用优先：继续使用 SnailAI 的模型、智能体、RAG、会话和内容过滤；不另建第二套聊天或知识平台。
- 风险分级：智办（读与解释）→ 智审（判断辅助）→ 智管（受控写入），控制强度逐级提高；智审默认不自动通过，智管高风险不免审批。
- 人在环：智审建议由审批人确认；智管变更由发起人确认，高风险场景还需审批或双人复核；AI 失败不阻塞原业务流程。
- 工具分型：只读查询与受控动作分开；动作工具逐项校验权限、影响范围、确认凭据，执行后回读并留痕；不得自由 SQL 或不受控直连改库。专用读写 MCP（如建设）只暴露按业务语义封装的读写操作，明确库账号、白名单、事务、回读、审计和回退。
- 可追溯：建议、依据、模型/提示词/知识版本、确认人、执行结果和失败原因可审计；不记录凭据和完整敏感内容。
- 契约协作：智控由佳都实施，通过数据/接口和业务拆解接入，不共享数据库或应用账号；接口可用不等于智控能力验收通过。
- 分能力验收：四类能力分别定义需求、设计、数据和验收，不以一类能力的完成推断另一类。
- 多模态按任务选型：本地优先 1～2 卡模型——GLM-4.6V-Flash（10.3B，1～2 卡）或 Qwen3.8-27B（27.8B，2 卡）；Qwen3.8-Flash-Next（约 180B，8 卡）、GLM-5.3-Flash（321B）、DeepSeek-V4.1-Flash（552B/763B，约 510GB 权重）不作为 2～4 卡方案；API Flash（DS V4.1 Flash、Qwen3.8-Omni-Flash）仅在千帆/佳都内网网关可用且数据合规时采用；8 卡不作为前置；上线前核对 Ascend 支持矩阵并真实材料评测，不以模型参数代替验收。
2.5 当前状态与路线
- 智办：工程基础试点已实施并通过技术验证；扩模块按阶段另行确认语料、工具授权和维护成本。
- 智审：本期不实施；任何审批场景的 AI 介入须先与业务部门确认节点、材料、规则、输出、人工确认和自动通过策略，再另立阶段。
- 智管：未选首批场景；先低风险高频操作，再角色/授权，最后岗位及流程定义联动；每个场景先定义风险级别、确认/审批矩阵、影响预览和回退；评估是否需要专用读写 MCP。
- 智控：佳都实施智能监控与风险预警；平台按阶段交付数据/接口、业务拆解、口径说明和受控访问，以佳都与业务方验收为准。
阶段划分与开放条件见需求分析；本文不重复需求正文，也不表示未实施能力已有接口或页面。
3. 责任边界（智办首期组件）
| 组件 | 负责 | 不负责 |
|---|---|---|
| 助手容器 | 可见性、模块识别、选择模式、真实状态 | 伪造权限、自动采集整页、持有模型密钥 |
| admin 身份适配 | 平台登录与 openId 绑定、受控用户上下文 | 根据模型 userId 切换主体 |
| SnailAI | 知识检索、工具选择、答案生成 | 决定工程数据可见范围 |
| 路 A | 公共目录、SQL 校验、执行限制与结果 | 动态工程授权、任意结构探索 |
| 路 B | 委托身份校验、动作权限、业务服务调用 | 自由 SQL、复制工程授权谓词 |
| 知识维护 | 来源筛选、冲突治理、版本与回归 | 用历史统计回答当前数据 |
服务认证只证明调用来自可信服务，不证明当前用户是谁；用户委托身份不能携带长期有效的权限快照代替实际授权查询。两路禁止因某条失败自动互相绕行。
4. 智办首期实施顺序
- 核实依赖、网关和嵌入协议，闭合平台身份与 openId 绑定、已有会话归属。
- 筛选工程基础语料，建立模块智能体，先以现有会话页验证知识问答。
- 全局挂载、七类页面映射、通用回落、手动切换；原会话页复用同一承载内容。
- 路 A 先实现校验和拒绝用例，再对准入公共对象开放；没有准入对象不连整库试跑。
- 路 B 先证明可信主体和两用户隔离，再提供工程基础有限查询。
- 分项验收，记录建库、更新、提示词修正耗时，再评估后续模块。
第 2、3 项可独立于业务数据查询推进。第 4 项只处理公共信息，但仍须服务认证。第 5 项身份失败则停止受限数据开放，不影响已完成知识问答成果，也不把阶段成果说成完整首期交付。
5. 关键取舍
5.1 会话与界面
嵌入协议已核验：URL 参数 agentId 受控可用、无生成状态回传、外壳只接收主题/语言单向下发。选择切换以“同 agent 复用 iframe、跨 agent 延迟到重新展开或确认时重建”实施，未建第二套聊天实现。
模块映射使用稳定组件标识，agentKey 与环境 agentId 分离。首期版本化静态配置即可，不建配置维护表和后台页面。自动/手动选择状态由真实嵌入状态驱动，外壳标题不能冒充实际切换。
5.2 知识处理
文档导入、docling/PaddleOCR解析、切片、向量化、索引、召回及智能体知识库绑定全部优先复用SnailAI现成RAG。平台不另建RAG服务、embedding流水线、向量库、检索器或切分器；只有实际能力验证发现缺口且影响既定目标时，才评估最小补充。资料筛选和版本清单是内容维护工作，不是一套新的RAG实现。
需求与操作章节优先，保留文档、章节、版本、来源。Markdown 优先直接解析，图片和扫描资料才使用 docling/OCR；抽查表格、单位及否定条件。真正限制检索库范围，不仅靠提示词要求“只回答本模块”。同一来源旧版与新版不得同时作为当前权威语料。
5.3 MCP
路 A 使用审定的公共对象集，SQL 结构校验和数据库权限共同控制；路 B 使用业务工具，复用业务服务与工程授权。路 B 不向模型暴露 SQL。查询统计口径与列表一致，不能先取前几页再由模型计算全量统计。
智审/智管的动作工具不直接复用智办只读契约：写入/变更动作另建工具契约，逐项定义权限、目标、确认、回读和失败恢复；不在本文预设接口。
智管可能需要独立的专用读写 MCP，与智办只读路 B 分开。若建设，优先复用既有业务服务；MCP 只暴露按业务语义封装的读写操作，不接受模型自由 SQL 或任意表操作，并明确库账号最小权限、白名单、事务边界、确认/审批凭据、回读、审计和回退。是否建设在详细设计阶段确认，不以此文表述为已确定架构。
5.4 过滤和控制台
过滤与授权并列。模型、知识写入、MCP 配置、聊天权限分别核实；隐藏平台菜单不能阻止用户直接访问 SnailAI 管理 API。未证明普通用户无法管理模型密钥前，不向普通用户开放控制台。
6. 故障和恢复
| 故障 | 用户表现 | 处理 |
|---|---|---|
| 注册/绑定失败 | 会话不可用，重新登录或重试 | 不匿名查询 |
| 智能体不存在或停用 | 模块助手暂不可用 | 修复环境绑定，不随机替换 |
| 知识索引失败 | 说明未更新范围 | 保留前一可用版本；旧规则已失效时停止相关知识回答 |
| SQL 拒绝 | 不在开放范围或需缩小条件 | 不暴露数据库内部错误全文 |
| 路 B 身份/权限失败 | 无法查询 | 不切管理员、不改 userId、不走路 A |
| 工具超时 | 查询暂不可用 | 可解释规则，不生成实时数字 |
| 流式过滤或服务中断 | 答案未完成 | 停止输出并标记，不能冒充正常结束 |
| 智审建议失败/超时 | 审批页提示辅助不可用 | 人工审批继续，不自动通过、不阻塞流程 |
| 智管执行中断 | 变更未完成或部分完成 | 停止后续步骤、回读实际状态、按预案恢复并留痕 |
按实际故障恢复，不提前增加自动重试和队列；智审/智管的失败处理在设计阶段另行细化，不能沿用智办的“只读失败不影响业务”结论。