从模糊提问
到可信报告

基于 LangGraph 的企业问数 Agent:混合检索、反问澄清、沙盒执行、反幻觉报告生成——每一步都有确定性约束,每个数字可溯源,将「提需求-排期-出报表」压缩为即时自助式分析。

DataAgent 演示:反问澄清 → 续跑 → 流式报告
反问澄清 → 口径确认 → 同会话续跑 → 流式报告与图表(演示数据,预录)
CORE FEATURES

为"答得准"设计的六个子系统

每一个子系统都对应一个明确的失效模式:口径歧义、检索盲区、数字编造、SQL 错写、单轮波动、执行安全。

🙋

反问澄清

确定性歧义词护栏 + LLM 可行性评估双出口;LangGraph interrupt 挂起,结构化问题卡片确认口径后同会话续跑。

🔎

混合检索

Qdrant 向量召回与 BM25 词面召回并行,RRF 融合排序;7 类分型知识条目由数据治理过程生成。

📊

报告生成 v2

上下文包注入(问题 · 口径 · 计划 · 每步 SQL 与 TopN 行);LLM 选图、代码注数;反幻觉规则约束事实边界。

🐍

沙盒深度分析

均值、中位数、分布、相关性等 SQL 难以表达的统计,由 LLM 生成代码、Docker 容器隔离执行。

🧪

双 Tier 评测

Tier1 SQL 执行对比(golden + 多数决);Tier2 报告质量评分(数字溯源硬检查 + LLM 软评)。

🔐

口令保护部署

Caddy basic_auth 整站门禁;demo schema 与真实数据隔离;Docker Compose 一键起停。

ARCHITECTURE

系统架构

兼容 Spring AI Alibaba DataAgent 的 SSE 协议与节点语义,前端零适配复用。

 DataAgent · 系统总架构
系统总架构

请求路径:用户 → Caddy(口令门禁)→ Nuxt 前端 → 兼容层 FastAPI(SSE 协议映射 · SQLite 会话)→ LangGraph 分析链路(11 节点状态机)→ PostgreSQL / Qdrant / 豆包 Ark LLM / Docker 沙盒。

🔗 打开交互式版本(视图聚焦 · 路径追踪 · 演示模式)  |  分析管线交互版

 DataAgent · 核心运行流程(分析管线 · 交互式)

11 节点主链全貌:意图识别 → 证据召回 → 查询增强 → Schema 召回 → 表关系推理 → 可行性评估 → 执行规划 → SQL 生成 → 语义校验 → SQL 执行 → 报告生成;反问澄清与 Python 沙盒两条条件支线在图中以虚线呈现。

DESIGN DECISIONS

五个核心设计决策

每个决策对应一个明确的失效模式,原则是:能用确定性代码约束的,不交给模型。

01两层表访问模型schema 安全 × 召回平衡
连接器白名单(物理层):原始表与竞品数据在连接器层面不可见,而非提示词约束。任务级动态注入(逻辑层):默认仅注入两张处理表的 Schema,商品属性表按表路由按需加入——Schema 噪声直接决定 SQL 质量。配套知识库是治理产物:7 类分型条目(字段注释、术语钉死、指标口径、业务规则、边界陷阱),而非文档刮取。
02混合检索管线向量 × BM25 × RRF
向量检索擅长语义相似,对 paid_amount 这类精确标识符区分度不足;BM25 精确匹配标识符但不容忍同义改写。双通道并行 + RRF 融合排序,检索前置 LLM 查询重写消解多轮指代。已知边界:检索失败静默降级为空证据,不阻塞主链路。
03反问澄清:确定性 × LLMinterrupt / resume
可行性评估 LLM 分类之后,确定性护栏强制覆写:歧义词护栏、数据信号词覆写、总量查询抑制——豁免词仅依据用户原始输入判断。触发后 interrupt 挂起,结构化问题卡片确认口径,答案经 resume 续跑并并入多轮上下文成为本轮事实来源。能用代码判断的,不交给模型掷骰子。
04报告生成的上下文注入选图智能 × 数据保真
上下文包 = 规范化问题 + 澄清口径 + 计划 + 每步执行包(分析意图、SQL、TopN 行)。SQL 是聚合意图的编码:主维度、排序优先级与口径都在 SQL 结构里,信息量高于裸结果行。图表 pass 职责分离:LLM 决定选什么图、回答什么;代码决定填什么数——图表数据不存在编造空间。事实纪律:执行结果是唯一事实来源,空结果不生成图表。
05快照解耦评测控制变量
上游链路跑一次冻结为状态快照,报告环节直调快照独立重跑——46 条全量报告评测从 25 分钟压缩到 5 分钟,且分数波动只来自被测部分。评测同时承担探针职能:报告层异常可归因上游 SQL 或数据质量问题。
EVALUATION & REPLAY

评测结果与在线回放

评测对象、方法与当前结果。Tier1 与 Tier2 的一致性标准不同:SQL 有标准答案,对比从严;报告没有标准答案,底线是无中生有。Tier2 采用数字溯源硬检查(60%)+ LLM 软评(40%)混合打分,配 25% 量级否决;经 8 轮回归迭代,硬检查通过率 82% → 99%、软评均分 91 → 99。

46/46
Tier1 SQL 执行
46 条 golden · 3 次多数决 · 并发 10
82→99%
数字溯源硬检查通过率
44 条用例 × 4 项硬检查
91→99
LLM 软评均分(百分制)
洞察与表达两维度
7/7
反问触发与收敛
双解 golden 全部触发并收敛
 DataAgent · 双 Tier 评测体系
双 Tier 评测体系

结论的局限已声明:SQL 生成与报告撰写依赖 LLM,存在单轮波动;多数决与确定性护栏用于约束该波动。评测脚本与 golden 定义见仓库。

在线回放

三个预录会话的完整 SSE 帧回放——时间线、澄清卡片、流式报告与图表,按真实时间轴重现。点击进入,播放器支持暂停与倍速。