主题
AI引擎底座 · 需求分析
文档版本：3.10 ｜ 最近核对日期：2026-11-10
1. 背景与依据
平台使用 SnailAI 1.1.1 独立服务提供模型管理、智能体编排、知识库 RAG（docling 与 PaddleOCR）、短期记忆、内容过滤及技能。平台 admin 作为 Agent 与 OpenAPI 客户端，负责平台身份和业务授权，不重复建设模型平台。
2026-11-09 用户确认全局悬浮助手、逐模块智能体、模块资料分库、MCP 双路、知识与数据职责分离，随后明确首期仅工程基础管理。
2026-11-10 与需求方会议确认平台 AI 能力分为智办、智审、智控、智管四类：智办面向各模块的自然语言办理辅助与查询；智审面向流程审批的智能审查辅助，本期不实施，审批场景须先与业务部门确认；智控由第三方（佳都）实施智能监控与风险预警，平台配合提供数据、接口、业务拆解和详细说明；智管面向平台层面的运维操作，通过 AI 把改手机号、授权、换岗位等跨角色、跨线路标段、跨流程定义配置的操作收敛为一次意图办理。本文以四类能力组织需求；已实施的工程基础试点属于智办首期，其余能力尚未实施，不能据本文表述为已上线。
设计参数与实现方式见概要设计及详细设计，其拟实施内容不表示已经上线。工程业务规则以工程基础需求为准，不能由 AI 文档另行定义。
2. 产品能力框架（2026-11-10 需求方确认）
2.1 四类能力
| 能力 | 目标 | 典型场景 | 当前状态 | 不包含 |
|---|---|---|---|---|
| 智办 | 在业务页面用自然语言获得办理辅助、规则解释和授权查询 | 工程基础规则问答、工点/单位工程查询、操作步骤说明、资料定位 | 工程基础试点已实施并通过技术验证 | 直接写业务数据、代替用户办理、自动读取页面表格/表单/附件、绕过业务权限 |
| 智审 | 在流程审批中提供智能审查和审批辅助 | 材料完整性检查、规则一致性核对、业务数据交叉核验、风险提示、审批意见草稿、补充材料问题清单 | 本期不实施；审批场景须先与业务部门确认后再排期 | 自动通过、代替审批人决定、修改流程定义、跨授权范围读取材料、编造审查依据 |
| 智控 | 由第三方（佳都）实施的智能监控与风险预警 | 进度滞后分析、手续办理缺少附件/条件、审批或履约风险识别，由 AI 分析并提示；平台提供数据、接口、业务拆解、口径说明、样例和受控访问 | 第三方实施，平台配合；本模块不实施 | 在本模块自建智控算法、页面或数据仓；第三方直连生产库或绕过平台权限 |
| 智管 | 用自然语言编排平台层面的运维变更 | 改手机号/邮箱、角色与授权调整、岗位变更及其线路/标段/流程定义联动、单次或受控批量维护；可能通过专用读写 MCP 执行受控动作 | 未实施 | 无确认的静默写入、绕过审批或权限、自由 SQL 或不受控直连改库、无边界批量变更、改变在途流程语义 |
四类能力不是四个独立系统：智办、智审、智管共用同一 AI 底座（身份、会话、模型、知识、工具、审计、内容过滤），智控按数据/接口契约协作，不接入平台聊天会话。不得为某一能力另建第二套聊天、知识库或模型平台。
2.2 能力关系与风险梯度
- 智办（读与解释）→ 智审（判断辅助）→ 智管（受控写入），风险逐级升高；人工确认、权限校验、影响预览、审计和失败恢复逐级加强。
- 智办只回答与查询，不改变业务记录；智审只给建议，审批决定权在人；智管可以执行变更，但必须经过影响预览、确认或审批、执行回读和审计。
- 智控属于外部能力，不在平台 AI 的信任边界内；通过最小权限的数据/接口和业务拆解协作，不以共享数据库或共享账号替代接口契约。
- 能力可以组合，但不能越级：智审不得因为模型判断而自动完成审批；智管不得复用智办的数据查询结果直接推导写入对象，必须在执行前重新校验目标与权限。
2.3 共同底座
| 底座能力 | 内容 | 复用要求 |
|---|---|---|
| 身份与会话 | 平台登录、openId 绑定、会话归属、智能体与会话隔离 | 智办/智审/智管共用；不得以模型参数或自报身份替代 |
| 知识与规则 | 按模块维护语料、来源版本、检索与引用 | 智审/智管复用同一知识治理；不得把规则解释权交给模型 |
| 工具与动作 | 路 A 公共查询、路 B 业务查询；智审只读并生成建议；智管增加受控动作工具/专用读写 MCP（候选） | 读写工具分型；动作工具必须校验权限、影响范围并留痕；智审不通过工具直接改变业务 |
| 模型与内容安全 | 模型配置、内容过滤、提示词与工具结果隔离 | 模型密钥不下发前端；检索文本和工具结果不作为系统指令 |
| 权限与数据范围 | 平台动作权限、工程数据授权、字段与附件可见性 | 在查询/执行时实时判定，不使用长期权限快照 |
| 审计与可观测 | 提问、检索来源、工具调用、建议、确认、执行结果、失败原因 | 智审/智管必须可追溯；不记录凭据和完整敏感内容 |
2.4 分阶段推进
| 阶段 | 能力 | 范围与门槛 |
|---|---|---|
| 阶段一（当前） | 智办 | 工程基础试点：规则解释、授权查询、会话隔离、路 A/路 B 只读工具。已完成技术验证，业务验收另行执行 |
| 阶段二 | 智办扩模块 | 按模块补充语料、工具授权和环境绑定；逐模块验收，不复制开发环境物理 ID |
| 暂缓（本期不实施） | 智审 | 任何审批场景的 AI 介入（节点、材料、规则、输出、是否自动通过）须先与业务部门确认，再另立阶段和验收；确认前不开发、不试点 |
| 阶段三 | 智管选点 | 先低风险高频场景（如手机号），再角色/授权，最后岗位及流程定义联动；每个场景先定义风险级别、确认/审批矩阵、影响预览和回退；评估是否需要专用读写 MCP |
| 并行 | 智控 | 第三方（佳都）实施智能监控与风险预警；平台按阶段交付数据/接口、业务拆解、口径说明和受控访问，以第三方与业务方验收为准 |
每阶段先确认验收标准、数据范围、权限边界和失败恢复，再开发；不以“能力已命名”或“智能体已创建”代替可用性。阶段之间不自动继承授权，生产开放须另行确认。
2.5 责任分工
| 角色/方 | 负责 | 不负责 |
|---|---|---|
| 平台 AI 引擎（本模块） | AI 底座、智办实现、智审/智管的编排与集成、智管专用读写 MCP（如建设）、智控的数据/接口支持 | 定义业务规则、代替审批人、不受控的直接改库或自由 SQL、替第三方实现智控算法 |
| 业务模块 | 业务规则、表单与材料、审批节点语义、数据权限、业务口径 | 把规则定义权交给模型；用 AI 输出替代业务确认；在业务部门确认前开展智审 |
| 流程引擎（Warm-Flow） | 任务、节点、办理人、流程状态、在途实例 | 由 AI 直接改写流程定义或跳过节点；智审不改变流程语义 |
| 平台运维/权限管理 | 用户、角色、组织、数据范围、流程定义配置的既有服务与审批 | 无确认的批量变更；绕过既有权限和审批 |
| 第三方（佳都，智控） | 智控的监控分析、风险预警、模型、页面及集成实施 | 直连生产库、绕过平台权限、未经授权导出数据 |
| 安全/审计 | 权限、数据分类、日志、合规复核 | 用“AI 已判断”替代审计结论 |
3. 智办首期范围
3.1 包含
- 所有已登录业务页面可唤起的单例全局悬浮助手；工程基础页面选择工程基础智能体，未登记页面回落通用会话。
- 工程基础一个模块智能体和一个模块知识库，覆盖项目、线路、标段、工点、单位工程、专业及工程授权的规则与操作解释。
- 保留市场和手动切换能力，不锁定智能体。其他智能体可见不等于其他模块已完成建设。
- 路 A：独立 MCP server 直连 DM8，对准入公共级低敏感数据进行受限 text-to-SQL。
- 路 B：admin 内 MCP server 承接带权限业务查询，以工程基础为首个适配域；身份和业务授权验证先于数据开放。
- 工程基础 20 题知识测试、路由与会话隔离、MCP 两路结果与拒绝边界验证。
3.2 不包含
- 安质环、招投标、公文、BIM、GIS 等模块智能体建设；后续扩展不属于本期实施范围。
- AI 修改业务记录、授权用户、发起审批、删除数据或批量导出明细。
- 自由全库 SQL、整库 schema 下发、绕过工程授权和动作权限。
- 新建智能体市场、知识库管理后台、模型管理后台、配置维护页面及独立数仓。
- 把源码具备能力、文档编写完成或服务在线表述为功能及业务验收通过。
4. 角色与权限
| 角色 | 能力 | 边界 |
|---|---|---|
| 平台登录用户 | 唤起助手、提问、选择可用智能体 | 不因使用 AI 获得额外功能或数据权限 |
| 工程基础业务用户 | 查询规则，使用已开放的数据工具 | 动作权限与原业务能力一致，工程范围由后端判定 |
| 审批人 | 在智审中查看建议、核对依据并作出审批决定 | AI 建议不是审批结论；审批责任仍在审批人 |
| 平台运维/权限管理员 | 在智管中发起、预览、确认或执行运维变更 | 受既有权限、审批和数据范围约束；高风险变更不得免审批 |
| 授权 AI 管理人员 | 维护模型、智能体、知识库和 MCP 配置 | 平台菜单权限与 SnailAI 内部管理权限分别生效；不代行业务审批 |
| 第三方实施方（佳都，智控） | 按数据/接口契约接入并实施智能监控与风险预警 | 最小权限、不得直连生产库、不得绕过平台权限 |
| 资料维护人员 | 核对语料、维护来源和版本 | 不能通过修改知识库替代业务规则确认 |
| 安全/审计人员 | 复核高风险操作、审计日志和权限配置 | 不以 AI 输出替代审计结论 |
解释某项操作不代表当前用户可以执行它。市场开放不代表其全部工具、知识及历史会话公开；数据工具不能以“已选择正确智能体”代替权限判定。智审/智管的操作使用发起人的现有权限，AI 不扩展权限；智管高风险场景还须经过审批或双人复核。
5. 功能需求与追踪
5.1 智办首期（已实施，技术验证）
| 编号 | 要求 | 验收结果（2026-11-10 技术验证） |
|---|---|---|
| AI-01 | 全局悬浮入口 | 技术验证通过（业务页可用、单实例、登录页无入口）；驾驶舱未逐项验证 |
| AI-02 | 工程基础模块识别 | 通过（线路台账页实测：标题与 iframe 实际智能体一致） |
| AI-03 | 通用回落和手动切换 | 通过（测试与验收 §1.4 已补手动切换、跨页保持、恢复跟随） |
| AI-04 | 模块专属提示词与知识库 | 通过（20 题回答可定位语料章节） |
| AI-05 | 知识与数据职责分离 | 通过（R15/R16 拒绝历史数字并实查；R20 不编造） |
| AI-06 | 路 A 受限查询 | 通过（A01～A08/A10/A11；A09 超时未实测） |
| AI-07 | 路 B 当前用户授权 | 通过（B01～B07） |
| AI-08 | 会话隔离 | 通过（ID01～ID06） |
| AI-09 | 知识资料更新 | 机制就绪（语料清单+批次）；实战升版回归待首次更新 |
| AI-10 | 结果与失败可解释 | 通过（拒绝/无结果/截断/依据不足均有区分表述） |
5.1.1 全局助手
首次在工程基础页面展开默认选择工程基础智能体。同模块切页保持会话，不反复注册。跨模块时自动模式跟随页面，手动模式保持用户选择，提供恢复“跟随当前页面”的入口。输出中的回答不得被误归到另一智能体；状态处理见详细设计。
首期仅使用页面模块信息，不自动读取页面表格、表单、DOM、截图或附件。用户提供的线路、标段、工点 ID 只是查询条件，不是授权证据。登录失效、身份获取失败时提示重新登录或重试，不匿名执行数据查询。
5.1.2 工程基础知识库
首批从六类模块资料筛选语料，不将六份全文机械入库。需求与操作手册为主，概要设计解释业务概念；详细设计、数据库与测试资料仅抽取仍有效且适合业务读者的段落。排除历史迁移计数、废弃规则、凭据、内部地址、测试人员信息和制作过程说明。
回答给出结论、适用条件、必要步骤与来源。没有依据时说明缺口；资料冲突先核对，不自行选择看似合理的答案。混合问题分开解释规则与实时结果，不以检索片段中的统计数充当当前事实。
5.1.3 MCP 路 A
公共指对全部实际可调用者可见，包含行、列及聚合结果。“不按工程范围过滤”“有菜单即可全量查看”均不等于公共。首期候选为工程标准分类和可公开字典子集，物理对象尚未准入。线路、标段、工点、单位工程、用户授权配置不得因属于基础数据直接开放。
专用账号仅对准入对象有 SELECT 权限，不复用应用或管理员账号。服务端落实单条允许查询语法、对象和列白名单、函数及关联限制、查询上限、超时和大表拦截。缺注释先对照业务资料补齐，库侧操作走项目纳管入口。没有合格对象时不开放路 A，不为演示降低门槛。
5.1.4 MCP 路 B
用户主体由可信服务链路建立，不接受模型参数、自然语言、自报 header、浏览器 openId 或固定 app-id 作为个人授权依据。平台 userId、SnailAI 内部用户 ID、openId 不得混用。
复用业务服务并逐项验证动作权限；工程数据按专属组合、工点共享、整线完整资源执行 EngineeringDataAccessHelper。无配置、异常配置、映射失败均 fail-closed。MCP 直调 Service 不会自动执行原 Controller 注解，适配层须落实动作鉴权。
5.2 智审（本期不实施，验收待定）
| 编号 | 要求 | 当前状态 |
|---|---|---|
| AI-S1 | 审批上下文接入：当前任务、节点、表单、附件、流程历史和前序意见，按审批人权限读取 | 本期不实施 |
| AI-S2 | 规则与数据核对：引用适用规则和授权数据，检查材料完整性、口径一致性和关键数据交叉核验 | 本期不实施 |
| AI-S3 | 审查输出：问题清单、风险提示、依据来源、建议意见草稿；区分事实、推断和不确定项 | 本期不实施 |
| AI-S4 | 人在环：审批人接受、修改或忽略建议；AI 不自动通过、不代替审批人签署意见 | 本期不实施 |
| AI-S5 | 审计与反馈：记录建议、来源、模型/提示词/知识版本、审批人决定和反馈，用于质量评估 | 本期不实施 |
智审本期不实施。 所有审批场景的 AI 介入——包括试点模块与节点、可读取的材料、规则来源、输出形式、与业务部门/审批人的确认方式以及是否允许特定低风险节点自动通过——必须先与业务部门确认，再另立阶段、设计和验收。确认前不开发、不试点，不以“智能体已创建”或“演示问答”代替业务确认。确认后默认仍只做辅助审查，审批决定由审批人作出；智审失败或超时不得阻塞原有人工审批流程。
5.3 智管（未实施，验收待定）
| 编号 | 要求 | 当前状态 |
|---|---|---|
| AI-M1 | 意图与目标解析：识别用户、角色、岗位、线路、标段、授权、流程定义等待变更对象 | 未实施 |
| AI-M2 | 影响预览：列出角色、数据范围、授权组合、流程定义和在途实例的影响，区分必须项和可选联动 | 未实施 |
| AI-M3 | 确认与审批：按风险级别要求本人确认、二次确认或审批；高风险变更不得免审批 | 未实施 |
| AI-M4 | 受控执行：通过既有平台服务或专用读写 MCP 执行；专用 MCP 只提供按业务语义封装的受控读写，不接受模型自由 SQL 或任意表操作；逐项校验权限、事务边界、回读和审计 | 未实施 |
| AI-M5 | 回读与回退：执行后核对实际状态；失败时停止后续步骤并按预案恢复，不能留下半完成状态 | 未实施 |
| AI-M6 | 审计：记录发起人、目标、变更前后、影响预览、确认/审批、执行结果和失败原因 | 未实施 |
智管按风险分级推进：
| 级别 | 示例 | 控制要求 |
|---|---|---|
| L1 低风险 | 本人手机号、邮箱、头像 | 身份校验后可本人确认执行，留痕；不涉及权限和流程 |
| L2 中风险 | 单个角色、单个数据范围或授权调整 | 权限校验、影响预览、本人/管理员确认；按制度决定是否审批 |
| L3 高风险 | 岗位变更引发的角色、线路/标段授权、流程定义办理人联动 | 影响预览、审批或双人复核、分步执行、在途实例保护、回读与回退 |
“一键完成”指一次意图加一次确认/审批后由系统按依赖顺序执行，不是无确认的静默批量写入。批量变更必须明确对象清单、范围和上限，不能由模型自行扩大。
智管可能需要一个专用的读写 MCP（与智办只读路 B 分开）。是否建设在详细设计阶段确认；若建设，至少满足：库账号独立且最小权限；只暴露按业务语义封装的读写操作，不接受模型自由 SQL、任意表或任意字段；每次执行校验发起人权限、目标范围、确认/审批凭据；明确事务边界、回读、失败停止与回退；全量留痕。优先复用既有业务服务，专用 MCP 用于现有服务无法覆盖的受控动作，不成为绕过业务规则的直连通道。
5.4 智控（第三方佳都实施，平台配合）
| 编号 | 平台责任 | 当前状态 |
|---|---|---|
| AI-C1 | 提供数据/接口清单：主数据（项目、线路、工点、标段、单位工程）、进度与手续办理数据、业务数据、流程状态、组织/用户/权限、知识与规则、附件访问约束 | 待佳都方案确认 |
| AI-C2 | 提供业务拆解和口径说明：对象关系、状态、枚举、粒度、统计口径、权限边界、风险场景和样例 | 待佳都方案确认 |
| AI-C3 | 提供受控访问：接口/数据服务、最小权限、审计、限流和 SLA；不提供生产库直连 | 待佳都方案确认 |
| AI-C4 | 联合验收：接口可用性、数据正确性、业务拆解一致性、风险提示效果、安全与权限 | 待佳都方案确认 |
智控的典型输出是智能监控与风险预警：例如识别进度滞后、某项手续办理缺少附件或前置条件、审批或履约存在风险，并由 AI 分析后给出提示和依据。具体监控规则、分析模型、提示方式、页面和集成由佳都方案确定；本模块不建设智控能力，不为其新增业务表或直连通道。第三方接入方案、数据范围和验收责任以双方契约为准。
6. 非功能要求
- 按低用户量低并发实施，不提前增加锁、队列、多模型路由或复杂调度。
- SQL 限制在服务端生效；前端停止等待不代表数据库取消成功。
- 知识同步失败不影响平台原业务，但不能宣称 AI 已使用最新规则；受影响知识应暂停或清楚限定旧版适用范围。
- 模型密钥只供授权管理人员管理，不下发聊天前端、提示词、工具参数或公开文档。
- 内容过滤复用 SnailAI 并验证实际覆盖入口；不能替代知识授权、动作权限、工程范围或 SQL 校验。
- 日志记录必要的查询范围、耗时、数量、拒绝原因与版本，不记录凭据和完整敏感结果。
- 智审/智管必须人在环：智审不自动通过，智管高风险不免审批；AI 失败时原业务流程可继续。
- 智管动作必须可审计、可回读、可回退；不得留下半完成状态；不得自由 SQL 或不受控直连改库，专用读写 MCP 须按业务语义封装并校验权限、事务和审计。
- 智控只通过受控接口/数据服务接入，最小权限、可审计、可限流；不得复制生产库或共享应用账号。
7. 验收与开放条件
知识问答、路由、会话身份隔离、路 A、路 B 分项验收，不能互相代替。20 题及评分建议见测试与验收。可以先交付知识问答阶段成果，但未开放或未验证的 MCP 必须逐项说明，不能声称首期全部完成。
四类能力分别验收，不以一类能力的完成推断另一类：
- 智办：现有 20 题、路 A/路 B、会话隔离和页面入口；扩模块时按模块重新验收语料和工具授权。
- 智审：本期不实施；进入阶段前须先与业务部门确认节点、材料、规则、输出、人工确认和自动通过策略；确认后按建议可追溯、审计完整、AI 失败不阻塞人工审批验收。
- 智管：每个场景先定义风险级别和确认/审批矩阵；影响预览准确；权限逐项生效；执行后回读；失败可恢复；审计覆盖变更前后；专用读写 MCP（如建设）按业务语义封装、最小权限、事务和回读验收，禁止自由 SQL。
- 智控：以佳都与业务方验收为准；平台交付接口/数据、业务拆解和受控访问，不把接口可调用等同于智控能力验收通过。
业务用户确认问题准确性、操作帮助和查询结果，技术验证与业务验收分别记录。逐模块推广前复核语料、工具授权和维护成本，不复制开发环境的物理智能体 ID。
8. 待核实事实
| 事项 | 当前结论（2026-11-10） | 完成条件 |
|---|---|---|
| 试点模块 | 智办首期仅工程基础管理 | 不再重新选模块；扩模块另行确认 |
| 四能力范围 | 需求方已确认四类能力方向；仅智办试点实施 | 智审本期不实施；智管按阶段；智控由佳都实施 |
| 智审实施时点 | 本期不实施；审批场景须先与业务部门确认 | 业务部门确认节点、材料、规则、输出、人工确认和自动通过策略后另立阶段 |
| 智审质量与责任 | 未定义准确率门槛和责任边界 | 业务、风控、审计共同确认 |
| 智管场景与分级 | 未选首批场景；L1/L2/L3 为建议分级 | 业务方确认场景、确认/审批矩阵和回退责任 |
| 智管动作通道 | 可能新增专用读写 MCP，与智办只读路 B 分开 | 先确认是否复用既有服务；若建 MCP，明确库账号、白名单、事务、权限、回读、审计和回退 |
| 智管流程定义联动 | 未设计在途实例保护和流程定义变更规则 | 与流程引擎、业务方确认兼容和切换方式 |
| 智控范围 | 佳都实施智能监控与风险预警；平台配合提供数据/接口与业务拆解 | 佳都方案、数据/接口清单、验收责任和 SLA |
| 模型能力与多模态 | 佳都反馈（2026-11-10）：昇腾 910B4 单卡 64GB、不支持 FP8；2 卡 128GB、4 卡 256GB、8 卡 512GB。Hugging Face 现行可核实：GLM-4.6V-Flash（10.3B、图像/视频/文本、128K、MIT、BF16 约 21GB，1～2 卡）；Qwen3.8-27B（27.8B dense、原生图像/视频、262K～1M、Apache-2.0、BF16 约 56GB，2 卡）；Qwen3.8-Flash-Next（约 180B、BF16 约 360GB，8 卡）；GLM-5.3-Flash（321B，8 卡 W8A8）；DS V4.1 Flash（552B/763B、权重约 510GB，8 卡不可行，仅 API/千帆）；Qwen3.8-Omni-Flash（API-only）。优先 1～2 卡本地多模态，8 卡不作为前置 | 确认 910B4 单卡 64GB 与可用卡数；核对 MindIE/vLLM-Ascend 对 Qwen3.8-27B、GLM-4.6V-Flash 及 BF16/W8A8 的支持；确认千帆内网是否提供 DS V4.1 Flash 及数据合规；用真实审批材料评测扫描件/表格/图纸/照片、时延与并发；模型卡、许可证与硬件规格由佳都书面确认 |
| MCP 动态身份 | 已实现：SnailAI 自有 Order 45 处理器按配置 baseUri 注入短期委托，验证端建立受控主体 | 两用户隔离已验证（B05）；生产部署需按环境配置密钥与 baseUri |
| 嵌入页切换 | 已核验：URL 参数 agentId 支持，单向外壳主题消息，无生成状态通道；外壳重建 iframe 切换 | 手动切换完整交互回归已补（测试与验收 §1.4） |
| 会话绑定 | 已实现 validator（签发+每请求校验）与会话归属校验（Order 16） | ID01～ID06 已验证；重登不串账号待浏览器实测 |
| 公共物理白名单 | 已准入 3 对象（BIZ_MAJOR_DICT/SYS_DICT_TYPE/SYS_DICT_DATA）+ 只读账号 | A11 权限目录核验通过；后续对象按准入流程扩 |
| 管理权限与内容过滤 | C01 通过（管理 API 拒绝平台 token、网关无 Key 泄露）；F02 流式过滤中断未实测 | 补流式过滤中断与深色/视口验证 |