智能问数与数据可视化

智能问数链路

智能问数将自然语言问题转换为 SQL，执行取数，再生成图表配置。数据源提供连接和结构，问数资源限定数据范围，并通过术语与查询示例表达业务口径。

一、配置对象

对象	作用
数据源	连接参数、数据库类型、表结构与关联信息
问数资源	模型、数据源、参与问数的范围及业务说明
术语	业务词汇、指标定义及计算口径
查询示例	自然语言问题与对应 SQL
仪表盘	已保存图表与展示布局

业务管理位于 business/datasource、business/insight，执行位于 blade-ai-insight。InsightEngineServiceImpl 组织 SQL、数据与图表阶段。

二、阶段事件

统一运行通道以 stage 区分产出，前端分别显示 SQL、数据和图表。

阶段	标识	产出
SQL 生成	sql	生成中的 SQL 与最终 SQL
查询取数	data	列定义与查询数据
图表生成	chart	ECharts 配置

命名事件包括 intel_started、stage_started、text_chunk、stage_finished、intel_finished 与 ping。取数阶段不产生文本增量，进度与完成状态以 stage_started、stage_finished 等阶段事件为准。

三、数据范围与查询

问数上下文由当前资源的数据范围、表结构、关系、术语和示例构建。前端分别展示同一次运行的 SQL、查询数据与图表，三者可相互对照。

数据源账号

业务分析使用只读数据库账号，并仅授予需要的数据范围。模型生成 SQL 与数据库权限分别约束查询语义和实际可执行操作。

数据源查询控制台、问数运行和图表生成是不同入口。开发时保留各入口的权限与结果结构，不将控制台执行能力直接暴露给普通问数使用者。

四、指标与可视化扩展

指标口径优先维护为术语，常见问题维护为查询示例。需要修改模型生成规则时，检查 insight 引擎的提示词构建与执行上下文，不在页面拼接另一套 SQL 规则。

图表在前端按返回配置渲染，仪表盘保存图表与布局。修改返回协议时同步事件类型、阶段产出与消费端，使图表与本次查询结果保持一致。

操作见 SQL 查询与图表分析。