Agentic BI - AI 驱动的商业智能工具¶
产品定位¶
Agentic BI 是一个基于多智能体协作的商业智能工具，核心能力是将自然语言查询转换为 SQL 并生成可视化分析。项目采用轻量级架构，重点验证多代理协作 + BI 查询/分析闭环，而非企业级完备性。
核心特性¶
- 多轮对话：支持上下文追问与条件继承
- 多智能体协作：Router + Executor + Reviewer 三层架构
- 实时推理链：Claude 风格内联 reasoning UI
- 自我修正：Self-correction 机制降低错误率
- 澄清反问：模糊问题先澄清再执行
- 保险专属技能：针对保险行业的专业分析
技术栈¶
后端架构¶
- API 框架: FastAPI
- 数据引擎: DuckDB（轻量级分析数据库）
- 多智能体: 自研轻量框架（非 LangGraph/AutoGen）
- 模型服务: Azure OpenAI（支持多模型配置）
- 流式输出: SSE（Server-Sent Events）
前端技术¶
- 框架: React + TypeScript
- 图表: Recharts
- 认证: Logto
- UI 风格: Claude 风格对话界面
数据与部署¶
- 业务场景: AIA 保险数据（多表 schema）
- 容器化: Docker + PM2 托管
- 环境: HTTPS 开发域名 + Caddy 反代
项目时间线¶
| 时间节点 | 里程碑 | 关键成果 |
|---|---|---|
| 2026-03-10 | 项目启动与核心实现 | POC 完成，多智能体协作成功 |
| 2026-03-16 | 文档规范化 | PRD、CONTEXT 整理完成 |
| 2026-03-17 | 项目归档 | 功能完备，BiBot 进入维护状态 |
| 2026-03-18 | 部署环境优化 | 容器修复，HTTPS 环境配置 |
| 2026-03-20 | 运维问题处理 | 前端构建、配置页修复 |
| 2026-04-05 | 可视化升级 | React Flow 流程图集成 |
关键决策记录¶
架构选型决策¶
- DuckDB over 传统数仓: POC 阶段无需重型基础设施，DuckDB SQL 能力强且适合本地分析
- 自研多智能体 over 框架: Dad 要求"不要太繁杂"，验证协作理念而非框架能力
- FastAPI 单服务: API + 静态文件统一服务，避免前后端分离的代理问题
交互设计决策¶
- Claude 风格 UI: 推理链内联展示、小字、支持折叠，不用右侧滑入面板
- 澄清反问机制: 模糊问题先反问参数，而非硬猜，提升交互合理性
- 默认"进行中"视图: 全量节点图过大，筛选活跃任务更符合工作台场景
模型配置策略¶
- 多模型支持: Router/Reviewer/Executor 可独立选择模型（gpt-5.4/gpt-4o等）
- Azure OpenAI: 企业级稳定性，避免 API 限制问题
核心功能模块¶
1. 多智能体协作¶
- Router Agent: 理解自然语言，选择合适技能，组织执行参数
- Executor Agent: 执行 SQL 查询和数据分析技能
- Reviewer Agent: 审核结果合理性，触发修正循环
2. BI 分析技能¶
- 基础统计: summary_statistics（总量、均值、分布）
- 排名分析: ranking_analysis（Top/Bottom N）
- 趋势分析: trend_analysis（时间序列，支持维度拆分）
- 同比分析: year_over_year_comparison
- 保险专属: 续保率、理赔时效等业务指标
3. 可视化能力¶
- 表格: 默认展开（无图表场景）
- 图表: Recharts 驱动的动态可视化
- 流程图: React Flow + dagre 布局的任务关系图
子页面导航¶
- [[03-10-启动与核心实现]]: 项目启动、技术选型、核心功能实现
- [[03-16-文档与归档]]: PRD 整理、CONTEXT 规范、项目状态转换
- [[03-18-部署与环境]]: 容器修复、HTTPS 配置、开发环境优化
- [[03-20-运维与修复]]: 前端构建、配置页、线上问题处理
- [[04-05-可视化升级]]: React Flow 集成、流程图布局、交互优化
技术亮点¶
多轮对话设计¶
通过 session 管理实现上下文保持，支持基于前次结果的追问。示例： 1. "保险产品排名" → 返回排名表 2. "按月看趋势" → 自动继承产品上下文 3. "华东过滤" → 叠加地域条件
Self-correction 机制¶
Reviewer 不仅判断通过/不通过，还提供修正提示，主流程支持多次迭代修正，显著提升分析准确率。
业务数据深度¶
从通用销售数据切换到 AIA 保险多表 schema，支持保单、理赔、续保等真实业务场景分析。
项目状态¶
状态: 归档（功能完备）
维护: BiBot 响应相关咨询
访问: 开发环境可访问，生产环境已部署
该项目成功验证了多智能体在 BI 领域的应用价值，为后续企业级 BI 工具建设提供了技术基础和设计参考。