v2.9.x · LangGraph · 7层自纠错 Pipeline

DeepRAG
Agentic RAG 问答系统

企业级技术文档智能助手 — 混合检索 + Corrective RAG + 可选 Self-RAG 闭环

源码仓库 在线 Demo (即将上线) 查看架构

真实场景痛点

学习 LangChain/LangGraph 时,官方文档分散在 4-5 个站点,版本更新快,查一个问题平均花费 10-30 分钟

📚

查找困难

同一概念在 Python 文档、JS 文档、API Reference、GitHub 多页面分散,需人工整合

耗时严重

查一个问题平均 10-30 分钟,打开多个标签页、比对版本差异

🔄

重复劳动

同一类问题反复查(API Key 配置、LCEL 语法),缺乏积累复用

📉

效率低下

花大量时间查文档,真正写代码时间不到 50%

❌ 传统 RAG

问题:"LangChain 0.3 有什么新特性?有没有已知 bug?"

→ 只能查本地文档库
→ 无法回答实时信息
→ 版本差异需人工比对
→ 答案可能包含幻觉

✅ Agentic RAG

问题:"LangChain 0.3 有什么新特性?有没有已知 bug?"

→ 识别查询意图:新特性(文档)+ bug(实时)
→ 并行调用工具:Vector Search + GitHub Issues API
→ 综合答案:完整回答两个子问题
→ Self-RAG 事实校验:降低幻觉率

7层自纠错 Pipeline

基于 LangGraph 状态机,含 Corrective RAG 纠错循环和 Self-RAG 自我反思循环

核心节点
决策分支
事实校验
输出
纠错路径

动态工具路由

Agent 根据查询类型自动选择最佳检索策略,点击下方按钮查看不同场景的路由路径

技术架构

核心组件与技术选型

LangGraph
状态机编排引擎
Qdrant
生产级向量数据库
BM25
关键词检索
RRF
混合排序融合
Cross-Encoder
精排 Reranker
Streamlit
Web 交互界面
FastAPI
REST API 服务
SiliconCloud
LLM 后端 (GLM-Z1-9B)
bge-base-zh
中文 Embedding
jieba
中文分词
Docker
容器化部署
MCP Protocol
工具调用协议

性能与评测数据

所有数据来自项目真实评测,可追溯至源文件,遵循审计真相表口径

检索准确率提升

来源: README.md - 两阶段检索效果对比

向量数据库写入速度对比

来源: docs/向量数据库性能对比报告.md (对数坐标)

版本演进与准确率

来源: README.md - 7个月持续迭代

RAGAS 评测雷达图

来源: evaluation_reports/ragas_report_20260521_140012.md (5题样例)

评测资产

来源: docs/审计真相表_P0.md — 代码/文档/评测三方说同一种真话
60
Golden 主测试集
150
意图专项评测 (L1≈72%)
20
E2E 回归测试
92%
幻觉检测准确率

版本演进

来源: README.md - 7个月持续迭代