
本文面向关注 NL2SQL / ChatBI 落地的技术读者系统拆解数智安全问数平台的整体架构、关键设计、质量保障与部署方案。文中配图取自平台方案材料与系统实际界面案例数据为演示环境。1. 背景企业 NL2SQL 落地的三个真问题大模型让用自然语言查数据库在技术上成为可能但在企业环境里真正落地通常卡在三个问题答案可信度——模型生成的 SQL 是否查对了表、算对了口径错了谁来发现口径一致性——同一个指标不同部门算法不一模型按谁的算可维护性——上线之后业务规则变了是重新做一次还是能持续演进数智安全问数平台围绕这三个问题给出了工程化答案。它的核心设计原则一句话可以概括模型负责理解表达业务规则决定如何取数。2. 整体架构三层支撑平台由核心处理层、基础支撑层与数据层构成全部按项目环境部署或连接核心处理层问答编排、查询生成、结果加工与解释基础支撑层对话模型理解表达、相似内容检索模型样例与用语召回、Trino 查询引擎跨源联邦查询数据层连接客户既有业务数据库不迁移、不复制、不改变业务系统运行方式。从更完整的视角看平台在客户系统与使用者之间承担语义中间层的角色值得强调的是定位的克制原业务系统继续办理业务、继续产生数据平台只负责查清问题。接入前提只有两条——数据能连接业务范围明确。3. 六步执行链路一次提问在平台内部经过六个环节理解提问对话模型解析业务语言识别业务对象、条件与意图相似检索检索模型从已验证的问答样例与业务用语中匹配参照生成查询依据回答规则Prompt 模板与数据模型生成查询语句执行查询经 Trino 查询网关下发至客户数据库执行取回真实数据结果加工按问题类型组织结论、图表与明细解释与溯源返回结果解读与数据来源实际执行的 SQL 与明细可核对。这个链路的关键在于第 6 步答案不是生成出来的文字而是执行查询后的真实结果。下面是一份答案页的实际呈现演示环境思考过程、实际执行的 SQL、可视化结果与结果解读同屏展示。以园区空置分析为例生成的查询形如示意SELECT building_name AS 楼栋名称, COUNT(*) AS 空置房源数, ROUND(COUNT(*) * 100.0 / SUM(COUNT(*)) OVER (), 2) AS 占比 FROM park_building_resource WHERE house_status 空置 GROUP BY building_name ORDER BY 空置房源数 DESC;同时标注引用来源园区建筑房源资源 /park_building_resource业务人员可以下钻核对到具体记录。4. 关键设计一语义层——业务数据模型直接让模型面对原始库表是 NL2SQL 口径失控的主要根源。平台的做法是先建业务数据模型把字段变成业务含义明确查什么、怎么算、按什么分类。建模要点按业务对象建模如园区场景按楼宇房源、租客企业、租赁合同、合同账单分别建模避免把房源数量与合同数量混为一谈分清字段用途名称类字段用于分类数值类字段用于统计统一计算规则日期口径与去重规则全局统一如空置的定义、当月收缴率的分母不改原表结构使用现有数据建立查询模型业务系统零改动。在园区案例中五类业务对象通过视图与语义模型关联起来支撑自然语言经营分析5. 关键设计二表达与取数分离——Prompt 管理与 FewShot 样例库5.1 回答规则Prompt 管理平台把选数据、写查询、解释结果的任务要求固化为可维护的模板并把业务统计条件写入其中。修改规则后要求用标准问题复查——这一条是防止改了一处、错了别处的工程纪律。5.2 FewShot 样例库已验证的问法与标准 SQL配对保存覆盖统计、趋势、明细三类问题。运行时检索模型按相似度召回让模型见过类似的题同类问题直接复用这套机制的工程价值在于每一次人工核验都成为资产。样例库越用越厚生成质量随使用时间提升而不是停在一次演示的水平。6. 关键设计三查询执行层——Trino 查询网关数据连接与查询执行统一收敛到 Trino 查询网关统一连接集中维护数据连接支持多数据源联邦元数据浏览库、表、字段一目了然为建模提供依据先试查再使用连接配置完成后必须试查验证才进入正式问数链路查询日志执行记录可回溯为质量定位提供证据链。7. 质量保障把质量门禁做成工程设施这是平台区别于一般 ChatBI 演示品的关键设计。上线不是终点问数质量门禁对智能体问数链路进行自动巡检工作方式概括为三步保留标准问题明确每个标准问题应该查到什么基准定位出错环节自动巡检把问题归因到数据、查询或连接环节并给出修复建议重复验证调整后用标准问题复查直至通过。配合模型可选择、查询可查看、规则可维护的运行设计实施团队可以长期维护平台而不依赖开发方驻场。8. 部署与安全部署方式对话模型、相似内容检索模型、Trino 引擎与企业数据库按项目环境部署或连接权限边界优先使用专用只读账号约定可查对象与结果范围运行管理连接凭证统一管理、查询记录全量留存、配置定期检查——安全要求落实为可执行的日常制度而非口头承诺。9. 落地验证智慧园区场景平台已在智慧园区完成落地对接楼宇房源、租客企业、租赁合同、合同账单四类经营数据不改原业务表结构。三个典型问法的实测结果演示环境数据问题平台回答业务用途各楼栋空置房源有多少间合计 7175 间最高楼栋 891 间、占比约 12.42%来源可查资源盘点、招商排查每月收缴率如何变化按月绘制趋势曲线异常月份可下钻收费跟踪、异常核对各费用类型的应收和实收是多少费用分布与金额对比可核对账单明细对账、欠费排查图表类型随问题语义自适应查数量突出总数、做比较按名称对比、看趋势按月份绘制曲线、查明细提供列表分页与导出。10. 扩展方向与建设建议园区之外协同办公OA 超期事项、经营管理ERP 延迟订单、客户管理CRM 商机阶段、财务收费未收款项等系统均可评估接入接入范围取决于数据开放条件。给计划落地的团队三条建议从一个业务范围开始选问题业务对象 典型问法 可用数据→ 做验证建模型、配样例、与原系统核对→ 再推广部署培训、逐步扩面验收回答四个问题数据对不对与原系统同口径核对、问题理解对不对、结果能不能用、后续能不能维护把样例库当资产管理每次人工核验都沉淀进 FewShot 样例库这是平台越用越准的根本原因。结语NL2SQL 的企业级落地难点从来不在能不能生成 SQL而在生成的 SQL 是否可信、口径是否一致、系统能否长期维护。数智安全问数平台通过表达与取数分离 语义层建模 样例资产化 质量门禁的组合把这个问题工程化了。欢迎在评论区交流你在 ChatBI / NL2SQL 落地中遇到的口径管理与质量保障问题。