Ragent · 企业级 Agentic RAG 智能问答系统产品系统Vibe Coding

面向企业内部知识问答场景：员工咨询的请假报销制度、IT 故障处理、OA 与中间件等答案散落在 PDF、Word、Excel 和网页里，关键词检索命中率低，通用大模型又不掌握企业内部信息

springai-ragent 是用 Spring AI 实现的企业级 Agentic RAG 问答
后端，覆盖从文档入库到智能问答的完整链路，用于系统实践生产级 RAG 的工程问题。主要功能模
块包括：一是文档入库模块，支持 PDF / Word / Excel / HTML / Markdown 多格式解析、扫描
件 OCR 识别、文本清洗与抽取质量闸门、递归与句子级切分、切片快照与文档代际管理，并可通过
RocketMQ 异步向量化；二是知识库管理模块，提供多租户知识库与文档注册、状态追踪、重传与删
除；三是 RAG 问答模块，包含查询改写、树形意图识别与澄清引导、多路并行检索、重排、证据门
禁、上下文组装与引用回链，支持同步与 SSE 流式两种返回；四是工具调用模块，本地 Tool 与
MCP 工具接入、工具准入、工具预取与无证据兜底回答；五是热点问答缓存模块，基于问题安全签名
的缓存复用与失效；六是多模型路由模块，多候选调度、健康检查、熔断与自动降级；七是
embedding 版本迁移模块，支持双写、快照回填、冻结评测与原子切换回滚；八是会话模块，会话
记忆持久化、滑动窗口与摘要压缩、中断落库；九是可观测模块，Prometheus 指标与链路追踪。

入库可靠性:提取、清洗、质量闸门、切片快照、文档generation防止迟到消息覆盖新内容。
RAG问答:改写意图tenantKB过滤检索去重/重排模型生成;支持同步和 SSE。
多租户和记忆:KB、文档、向量、会话均按用户隔离;消息与摘要持久化到PostgreSQL。
多模型韧性:候选路由、熔断、同步/流式首包前降级、rerank本地兜底。embedding
迁移:独立候选表、双写、可恢复快照回填、冻结评测、原子cutover/rollback、缓存版本隔离
可观测性:Actuator、Prometheus、模型/Token指标与traceld/spanld/requestld。