已上线

RAG Agent:本地知识库智能助手

Open-source Agentic RAG · React 19 + FastAPI

📅年份:2026
📂类别:AI
状态:已上线
许可:MIT 开源
在 GitHub 查看源码

项目概述

这是一个从需求、架构、实现、测试到开源发布均由个人主导的 Agentic RAG 工程。后端采用 FastAPI,前端采用 React 19;文档经过解析、OCR、语义切片后写入 Qdrant 与 SQLite BM25 双索引,查询阶段通过加权 RRF、消歧、去重、质量过滤与可选 Cross-Encoder 精排组织证据。自研 ReAct 循环支持多工具并行、上下文预算、循环收敛、长期记忆与联网检索升级;答案生成后继续检查引用真实性、引用位置和数字一致性,并在证据不足时有界修复或拒答。工程侧补齐 JWT/SSE、Alembic、持久入库任务、重启恢复、备份恢复、Prometheus 指标、审计日志、Docker E2E 与发布质量门禁。项目自建固定合成基准包含 93 条受控问答:回答忠实度与引用精确率为 98.48%,拒答准确率为 100%;这些数据用于工程评测与复现,不直接外推到任意业务数据。

系统架构

01
文档解析与持久任务
02
Qdrant + BM25 双索引
03
RRF 融合与精排
04
ReAct 多工具推理
05
引用校验与有界修复
06
SSE 流式交付

核心功能

Qdrant 语义检索 + SQLite BM25 + 加权 RRF
自研 ReAct 循环、多工具并行与自动收敛
来源卡片、行内引用与回答后验证
持久入库任务、失败重试与服务重启恢复
JWT / SSE / Alembic / 备份恢复完整工程链路
93 条受控问答评测与可复现质量门禁

技术栈

PythonFastAPIReact 19QdrantBM25RRFReAct AgentSSEDockerEvaluation