rag-demystified
rag-demystified 是一个从零构建的、由大语言模型驱动的先进 RAG(检索增强生成)管道示例。它的核心目标是“去神秘化”,即通过透明化的方式展示高级 RAG 系统的内部运作机制。当前流行的 RAG 框架虽然降低了使用门槛,但也带来了黑盒效应,使得用户在遇到错误或不一致时难以定位问题根源,甚至无法评估系统的实际成本。
rag-demystified 适合希望深入理解 RAG 原理的开发者、研究人员以及技术爱好者。它摒弃了过度封装的抽象层,以子问题查询引擎为例,将复杂流程拆解为数据仓库管理、向量检索及响应生成等核心组件。通过处理跨多个数据源的复杂问答任务,rag-demystified 不仅揭示了高级 RAG 的机械原理,还帮助使用者识别其中的局限性与潜在风险。对于想要掌握 RAG 底层逻辑而非仅仅调用 API 的技术人员来说,这是一个极佳的实践参考,能够让人真正看懂数据在系统中是如何流动的。
使用场景
某金融分析团队正在开发一个支持多城市经济数据对比的智能助手,需处理跨文档的复杂事实查询。
没有 rag-demystified 时
- 依赖高层抽象框架导致内部逻辑不透明,难以定位回答错误的根本原因。
- 面对“哪个城市人口最多”这类跨源问题时,无法看清子问题拆解与合并的具体过程。
- 出现信息幻觉时缺乏来源追踪能力,无法验证生成内容是否准确引用了原始文档。
- 调试困难,无法评估不同检索策略对最终成本和延迟的实际影响。
使用 rag-demystified 后
- 通过从零构建的流水线清晰展示向量检索、重排序及生成的完整执行链路。
- 直观观察子问题引擎如何将复杂查询分解为单文档任务并聚合结果。
- 能够直接检查中间检索到的数据块,快速调整参数以解决召回不准的问题。
- 明确掌握每个推理步骤的资源消耗,便于针对性优化系统性能与响应速度。
它将高级 RAG 流程从不可见的黑盒转变为透明可控的工程实践,显著提升系统可维护性。
运行环境要求
- 未说明
未说明
未说明

快速开始
揭秘高级检索增强生成 (RAG) 管道
由大型语言模型(LLM)驱动的检索增强生成(RAG)管道在构建端到端问答系统中越来越受欢迎。LlamaIndex 和 Haystack 等框架在使 RAG 管道易于使用方面取得了显著进展。虽然这些框架为构建高级 RAG 管道提供了出色的抽象,但这是以牺牲透明度为代价的。从用户角度来看,底层发生了什么并不显而易见,特别是在出现错误或异常情况时。
在这个 EvaDB 应用中,我们将通过检查通常保持不透明的机制、限制和成本,来揭示高级 RAG 管道的内部工作原理。
在笔记本电脑上工作的 Llama 🙂
快速开始
如果您想立即开始,请使用以下命令运行应用程序:
pip install -r requirements.txt
echo OPENAI_API_KEY='yourkey' > .env
python complex_qa.py
RAG 概述
检索增强生成(RAG)是一种用于基于 LLM 的问答的前沿 AI 范式。 一个 RAG 管道通常包含:
数据仓库 - 包含与问答任务相关的信息的数据源集合(例如,文档、表格等)。
向量检索 - 给定一个问题,找到与该问题最相似的 Top K 个数据块。这是使用向量存储(例如,Faiss)完成的。
响应生成 - 给定最相似的 Top K 个数据块,使用大型语言模型(例如 GPT-4)生成响应。
RAG 相比传统的基于 LLM 的问答提供了两个关键优势:
最新信息 - 数据仓库可以实时更新,因此信息始终是最新的。
来源追踪 - RAG 提供清晰的追溯性,使用户能够识别信息来源,这对于准确性验证和减轻 LLM 幻觉至关重要。
构建高级 RAG 管道
为了能够回答更复杂的问题,最近的 AI 框架如 LlamaIndex 引入了更高级的抽象,例如 子问题查询引擎。
在本应用中,我们将以子问题查询引擎为例,揭开复杂 RAG 管道的神秘面纱。我们将检查子问题查询引擎的内部工作原理,并将抽象简化为其核心组件。我们还将确定与高级 RAG 管道相关的一些挑战。
设置
数据仓库是包含与问答任务相关的信息的数据源的集合(例如,文档、表格等)。
在本示例中,我们将使用一个简单的数据仓库,其中包含多个关于不同热门城市的维基百科文章,灵感来自 LlamaIndex 的 说明性用例。每个城市的维基都是一个独立的数据源。请注意,为了简单起见,我们将每个文档的大小限制在 LLM 上下文限制范围内。
我们的目标是构建一个系统,能够回答诸如以下问题:
- “芝加哥的人口是多少?”
- “请总结亚特兰大的积极方面。”
- “哪个城市人口最多?”
如您所见,问题可以是针对单个数据源的简单事实型/摘要型问题(Q1/Q2),也可以是针对多个数据源的复杂事实型/摘要型问题(Q3)。
我们有以下检索方法可供选择:
向量检索 - 给定一个问题和一个数据源,使用来自该数据源中与问题最相似的前-K 个数据块作为上下文,生成 LLM 响应。我们使用来自 EvaDB 的现成 FAISS 向量索引进行向量检索。但是,这些概念适用于任何向量索引。
摘要检索 - 给定一个摘要问题和一个数据源,使用该数据源的全部作为上下文,生成 LLM 响应。
秘诀
我们的关键见解是,高级 RAG 管道中的每个组件都由单次 LLM 调用驱动。整个管道是一系列精心设计的提示模板的 LLM 调用。这些提示模板是使高级 RAG 管道能够执行复杂任务的秘诀。
事实上,任何高级 RAG 管道都可以分解为遵循通用输入模式的一系列单独 LLM 调用:

其中:
- 提示模板 - 针对特定任务策划的提示模板(例如,子问题生成、摘要)
- 上下文 - 用于执行任务的上下文(例如,最相似的 Top-K 个数据块)
- 问题 - 要回答的问题
现在,我们通过检查子问题查询引擎的内部工作原理来说明这一原则。
子问题查询引擎必须执行三个任务:
- 子问题生成 - 给定一个复杂问题,将其分解为一组子问题,同时为每个子问题识别适当的数据源和检索函数。
- 向量/摘要检索 - 对于每个子问题,使用所选的检索函数在相应的数据源上检索相关信息。
- 响应聚合 - 将来自子问题的响应聚合成最终响应。
让我们详细检查每个任务。
任务 1:子问题生成
我们的目标是将复杂问题分解为一组子问题,同时为每个子问题识别合适的数据源和检索函数。例如,问题 "Which city has the highest population?"(哪个城市人口最多?)被分解为五个子问题,每个城市一个,形式为 "What is the population of {city}?"({城市}的人口是多少?)。每个子问题的数据源必须是相应城市的维基百科,检索函数必须是向量检索。
乍一看,这似乎是一项艰巨的任务。具体来说,我们需要回答以下问题:
- 我们如何知道要生成哪些子问题?
- 我们如何知道每个子问题使用哪个数据源?
- 我们如何知道每个子问题使用哪个检索函数?
值得注意的是,这三个问题的答案都是一样的——一次单一的 LLM(大型语言模型) 调用!整个子问题查询引擎由一次精心设计的提示模板的单一 LLM 调用驱动。让我们称这个模板为 子问题提示模板。
-- Sub-question Prompt Template --
"""
You are an AI assistant that specializes in breaking down complex questions into simpler, manageable sub-questions.
When presented with a complex user question, your role is to generate a list of sub-questions that, when answered, will comprehensively address the original question.
You have at your disposal a pre-defined set of functions and data sources to utilize in answering each sub-question.
If a user question is straightforward, your task is to return the original question, identifying the appropriate function and data source to use for its solution.
Please remember that you are limited to the provided functions and data sources, and that each sub-question should be a full question that can be answered using a single function and a single data source.
"""
LLM 调用的上下文是系统可用的数据源名称和函数。问题是用户问题。LLM 输出一系列子问题,每个都包含一个函数和一个数据源。

对于这三个示例问题,LLM 返回以下输出:
LLM 输出表格
| 问题 | 子问题 | 检索方法 | 数据源 |
|---|---|---|---|
| "芝加哥的人口是多少?" | "芝加哥的人口是多少?" | 向量检索 | Chicago |
| "给我总结一下亚特兰大的积极方面。" | "给我总结一下亚特兰大的积极方面。" | 摘要检索 | Atlanta |
| "哪个城市人口最多?" | "多伦多的人口是多少?" | 向量检索 | Toronto |
| "芝加哥的人口是多少?" | 向量检索 | Chicago | |
| "休斯顿的人口是多少?" | 向量检索 | Houston | |
| "波士顿的人口是多少?" | 向量检索 | Boston | |
| "亚特兰大的人口是多少?" | 向量检索 | Atlanta |
任务 2:向量/摘要检索
对于每个子问题,我们使用选定的检索函数在相应的数据源上检索相关信息。例如,对于子问题 "What is the population of Chicago?"(芝加哥的人口是多少?),我们在芝加哥数据源上使用向量检索。同样,对于子问题 "Give me a summary of the positive aspects of Atlanta."(给我总结一下亚特兰大的积极方面。),我们在亚特兰大数据源上使用摘要检索。
对于这两种检索方法,我们使用相同的 LLM 提示模板。事实上,我们发现来自 LangchainHub 的流行 RAG Prompt(检索增强生成提示词) 开箱即用,非常适合此步骤。
-- RAG Prompt Template --
"""
You are an assistant for question-answering tasks. Use the following pieces of retrieved context to answer the question. If you don't know the answer, just say that you don't know. Use three sentences maximum and keep the answer concise.
Question: {question}
Context: {context}
Answer:
这两种检索方法仅在用于 LLM 调用的上下文上有所不同。对于向量检索,我们使用与子问题最相似的 Top K 个数据块作为上下文。对于摘要检索,我们使用整个数据源作为上下文。

任务 3:响应聚合
这是最后一步,将来自子问题的响应聚合成最终响应。例如,对于问题 "Which city has the highest population?"(哪个城市人口最多?),子问题检索了每个城市的人口,然后响应聚合查找并返回人口最多的城市。 RAG Prompt 在此步骤中也表现优异。
LLM 调用的上下文是来自子问题的响应列表。问题是原始用户问题,LLM 输出最终响应。

整合所有内容
在解开抽象层的奥秘后,我们发现了驱动子问题查询引擎的秘密成分——4 种类型的 LLM 调用,每种都有不同的提示模板、上下文和问题。这完美契合了我们之前确定的通用输入模式,与我们最初开始的复杂抽象相去甚远。
总结如下:

要查看完整流程的运行情况,请运行以下命令:
pip install -r requirements.txt
echo OPENAI_API_KEY='yourkey' > .env
python complex_qa.py
以下是系统回答问题 "Which city with the highest population?"(哪个城市人口最多?)的示例。

挑战
既然我们已经揭开了高级 RAG(检索增强生成)管道内部运作的神秘面纱,让我们来看看与之相关的挑战。
- 问题敏感性 - 我们观察到的这些系统面临的最大挑战是问题敏感性。大语言模型(LLM)对用户问题极其敏感,导致管道在某些用户问题上意外失败。以下是我们遇到的一些示例失败案例:
- 不正确的子问题 - 大语言模型有时会生成不正确的子问题。例如,"Which city has the highest number of tech companies?" 被分解为 "What are the tech companies in each city?" 5 次(每个城市一次),而不是 "What is the number of tech companies in Toronto?", "What is the number of tech companies in Chicago?" 等。
- 不正确的检索函数 - "Summarize the positive aspects of Atlanta and Toronto." 导致使用了向量检索(vector retrieval)函数,而不是摘要检索(summary retrieval)方法。
我们必须投入大量精力进行提示工程(Prompt Engineering),才能使管道针对每个问题正常工作。这对于构建稳健的系统是一个重大挑战。
为了验证这种行为,我们使用 LlamaIndex 子问题查询引擎 实现了该示例。与我们的观察一致,该系统经常生成错误的子问题,并且为子问题使用了错误的检索函数,如下所示。

- 成本 - 第二个挑战是高级 RAG 管道的成本动态变化。这个问题有两方面:
- 成本敏感性 - 问题的最终成本取决于生成的子问题数量、使用的检索函数以及查询的数据源数量。由于 LLM 对提示词敏感,问题的成本会根据问题和 LLM 输出而有显著差异。例如,上述 LlamaIndex 基线示例中错误的模型选择(
summary_tool)导致成本比vector_tool高出 3 倍,同时还会生成错误的响应。 - 成本估算 - RAG 框架中的高级抽象模糊了问题的预估成本。建立成本监控系统具有挑战性,因为问题的成本取决于 LLM 的输出。
- 成本敏感性 - 问题的最终成本取决于生成的子问题数量、使用的检索函数以及查询的数据源数量。由于 LLM 对提示词敏感,问题的成本会根据问题和 LLM 输出而有显著差异。例如,上述 LlamaIndex 基线示例中错误的模型选择(
结论
由 LLM 驱动的高级 RAG 管道彻底改变了问答系统。 然而,正如我们所见,这些管道并非即插即用解决方案。在底层,它们依赖于精心设计的提示模板和多次链式调用的 LLM。正如本 EvaDB 应用所示,这些管道可能对问题敏感、脆弱,且其成本动态不透明。理解这些细微差别是利用其全部潜力的关键,并为未来构建更稳健和高效的系统铺平道路。
常见问题
相似工具推荐
stable-diffusion-webui
stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面,旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点,将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。 无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师,还是想要深入探索模型潜力的开发者与研究人员,都能从中获益。其核心亮点在于极高的功能丰富度:不仅支持文生图、图生图、局部重绘(Inpainting)和外绘(Outpainting)等基础模式,还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外,它内置了 GFPGAN 和 CodeFormer 等人脸修复工具,支持多种神经网络放大算法,并允许用户通过插件系统无限扩展能力。即使是显存有限的设备,stable-diffusion-webui 也提供了相应的优化选项,让高质量的 AI 艺术创作变得触手可及。
everything-claude-code
everything-claude-code 是一套专为 AI 编程助手(如 Claude Code、Codex、Cursor 等)打造的高性能优化系统。它不仅仅是一组配置文件,而是一个经过长期实战打磨的完整框架,旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。 通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能,everything-claude-code 能显著提升 AI 在复杂任务中的表现,帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略,使得模型响应更快、成本更低,同时有效防御潜在的攻击向量。 这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库,还是需要 AI 协助进行安全审计与自动化测试,everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目,它融合了多语言支持与丰富的实战钩子(hooks),让 AI 真正成长为懂上
ComfyUI
ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎,专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式,采用直观的节点式流程图界面,让用户通过连接不同的功能模块即可构建个性化的生成管线。 这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景,也能自由组合模型、调整参数并实时预览效果,轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性,不仅支持 Windows、macOS 和 Linux 全平台,还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构,并率先支持 SDXL、Flux、SD3 等前沿模型。 无论是希望深入探索算法潜力的研究人员和开发者,还是追求极致创作自由度的设计师与资深 AI 绘画爱好者,ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能,使其成为当前最灵活、生态最丰富的开源扩散模型工具之一,帮助用户将创意高效转化为现实。
NextChat
NextChat 是一款轻量且极速的 AI 助手,旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性,以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发,NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。 这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言,它也提供了便捷的自托管方案,支持一键部署到 Vercel 或 Zeabur 等平台。 NextChat 的核心亮点在于其广泛的模型兼容性,原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型,让用户在一个界面即可自由切换不同 AI 能力。此外,它还率先支持 MCP(Model Context Protocol)协议,增强了上下文处理能力。针对企业用户,NextChat 提供专业版解决方案,具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能,满足公司对数据隐私和个性化管理的高标准要求。
ML-For-Beginners
ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程,旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周,包含 26 节精炼课程和 52 道配套测验,内容涵盖从基础概念到实际应用的完整流程,有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。 无论是希望转型的开发者、需要补充算法背景的研究人员,还是对人工智能充满好奇的普通爱好者,都能从中受益。课程不仅提供了清晰的理论讲解,还强调动手实践,让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持,通过自动化机制提供了包括简体中文在内的 50 多种语言版本,极大地降低了全球不同背景用户的学习门槛。此外,项目采用开源协作模式,社区活跃且内容持续更新,确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路,ML-For-Beginners 将是理想的起点。
ragflow
RAGFlow 是一款领先的开源检索增强生成(RAG)引擎,旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体(Agent)能力相结合,不仅支持从各类文档中高效提取知识,还能让模型基于这些知识进行逻辑推理和任务执行。 在大模型应用中,幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构(如表格、图表及混合排版),显著提升了信息检索的准确度,从而有效减少模型“胡编乱造”的现象,确保回答既有据可依又具备时效性。其内置的智能体机制更进一步,使系统不仅能回答问题,还能自主规划步骤解决复杂问题。 这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统,还是致力于探索大模型在垂直领域落地的创新者,都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口,既降低了非算法背景用户的上手门槛,也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目,它正成为连接通用大模型与行业专有知识之间的重要桥梁。