摘要：传统RAG通过"检索-生成"管线提升了LLM的准确性，但面对复杂查询时仍存在检索策略单一、缺乏推理规划、无法多步验证等问题。本文以JBoltAI平台为蓝本，深度拆解从传统RAG到AgentRAG的架构跃迁，重点分析AbstractReActChain的Template Method设计模式、五步ReAct推理流程，以及SimilarityGuard去重和140K Token上下文管理等关键技术细节。
一、传统RAG的局限性
传统RAG的流程是线性的：用户查询 → 向量化 → 知识库相似度检索 → Top-K文档片段 → LLM生成答案。这个架构面对以下场景暴露明显短板。
- 需要多步推理时：用户问"质量管理体系和ISO 9001标准有哪些差异？"，传统RAG检索到两份文档让LLM一次性对比，答案往往不够准确。
- 需要跨知识源查询时：用户问"客户投诉率和产品不良率是否有关联？"，传统RAG通常只能检索一个知识库。
- 查询意图不明确时：用户说"上次那个问题处理得怎么样了？"，传统RAG需要精确的关键词匹配，无法理解上下文指代。
JBoltAI平台通过引入ReAct（Reasoning + Acting）推理循环，让AI在面对复杂查询时能够"多步思考、多次检索、交叉验证"。
二、AbstractReActChain：ReAct推理链的基类架构
JBoltAI的核心推理基类AbstractReActChain（1400+行代码）采用Template Method设计模式——provider()方法声明为final，定义了完整的推理流程骨架，子类通过重写钩子方法定制特定行为。
推理主流程包括：输入提取 → 会话历史预加载 → 查询分析（ReActQueryAnalyzer） → 闲聊/自我介绍快速路径（跳过检索） → 经验匹配 → 执行规划 → 数据源路由 → 并发预检索 → ReAct工具循环（核心推理循环） → 后处理钩子 → 最终答案生成。
为避免不同ReAct子类的工具注册冲突，RagChain使用__react_前缀、DataChatChain使用__dc_前缀，内置工具在全局FunctionResourceCenter中互不干扰。
三、五步ReAct推理流程
第一步：查询分析
ReActQueryAnalyzer对用户查询进行多维度分析，输出原始查询、核心查询、提取的实体、关键方面、子查询列表和复杂度评分。查询分为FACTUAL（简单事实）、COMPARISON（对比分析）、ANALYSIS（深度分析）、PROCEDURAL（操作流程）、TROUBLESHOOTING（故障排查）五类，不同类型对应不同处理策略。检测到闲聊或自我介绍意图时直接跳过检索进入快速响应。
第二步：经验匹配
系统预存的经验条目包含触发关键词、检索策略指南和答案生成指南，匹配到时为后续步骤提供"经验加持"。
第三步：执行规划
ReActPlanner根据查询分析结果创建ExecutionPlan，包含有序步骤列表、步骤间依赖关系和计划类型。FACTUAL类型直接检索生成答案，COMPARISON类型分别检索对比双方再交叉验证，ANALYSIS类型多维度检索逐步推理，PROCEDURAL类型检索操作手册分步执行。
第四步：并发预检索
在ReAct循环开始前，同时查询知识库和数据源，预检索结果作为循环的初始"观测值"，减少循环次数。
第五步：ReAct工具循环
这是AgentRAG与传统RAG最本质的区别。LLM收到查询和当前上下文进行推理，如果判断信息不足就调用工具（知识检索、数据源查询等），工具执行结果作为"观测值"追加到上下文，LLM基于新上下文继续推理，重复直到信息充分生成最终答案。SimilarityGuard防止出现重复或高度相似的工具调用避免无效循环。ReActAbortManager支持用户中途取消推理。
四、继承体系与上下文管理
RagChain面向知识库问答，使用预置Prompt模板，重写postAnswerProcessing()将文档引用推送到客户端。DataChatChain面向数据分析，额外集成generate_chart工具生成ECharts图表，集成数据源路由和执行器进行数据库查询。两者共享基类推理引擎，通过不同Prompt模板、工具集和后处理逻辑实现场景定制。
框架将上下文Token预算设为140,000（200K窗口的70%），压缩策略分两阶段：先截断过长的工具执行结果保留摘要，再按时间顺序淘汰最早的历史消息，确保核心信息不丢失。
五、结语
AgentRAG的核心价值在于将"一次检索"升级为"推理驱动的多次检索"。JBoltAI的AbstractReActChain通过Template Method模式定义标准化推理流程，五步ReAct推理让AI面对复杂查询时思考、检索、验证有条不紊。140K Token管理和SimilarityGuard去重确保推理过程高效可控。从传统RAG到JBoltAI AgentRAG的跨越，本质上是AI从"信息搬运工"到"推理分析师"的角色升级。
ReAct推理链真的比传统RAG强吗？一个技术人的对比测评
传统RAG的流程是线性的：查询 → 检索 → 生成。检索只做一次，生成也只做一次。传统RAG应对不了需要对比分析、跨知识源查询、多步推理的场景，因为它的架构决定了"只能查一次、只能想一次"。
ReAct（Reasoning + Acting）的核心思想是让AI像人一样多步思考、多次检索、逐步推理。JBoltAI实现了五步推理流程：查询分析（把查询分为15种意图类型，不同类型对应不同策略）、经验匹配（调用历史经验指导检索策略）、执行规划（制定先查什么后查什么）、并发预检索（同时查知识库和数据源）、ReAct推理循环（AI根据需要多次调用工具，信息不够就换角度再查，直到判断信息充分）。
关键细节：SimilarityGuard防止AI重复检索相同内容，检测到相似查询时阻止执行并提示换角度；140K Token上下文预算，200K窗口的70%留给上下文，压缩策略是先截断长工具结果再淘汰最早消息。
传统RAG是"一次检索一次生成"，AgentRAG是"推理驱动多次检索"，AI自主决定何时检索、检索什么。传统RAG适合简单FAQ、单知识库查询、延迟敏感场景。ReAct AgentRAG适合需要多步推理的复杂问题、多知识源交叉查询、对比分析和故障排查。简单说，问"XX是什么"传统RAG够用，问"XX和YY的差异""为什么出现XX问题""分析XX趋势"ReAct更靠谱。
ReAct推理链不是万能的，增加的计算开销和Token消耗不容忽视。但在需要深度推理的场景下，"多想一步、多查一次"带来的准确率提升远超额外消耗。传统RAG解决了"AI会不会胡说"的问题，ReAct AgentRAG解决了"AI能不能把复杂问题想清楚"的问题。
