面向 LLM 与 AI Agent 的记忆操作系统,统一管理长期记忆的存储、检索与编辑。
GiovanniPasq/agentic-rag-for-dummies
基于 LangGraph 构建的模块化 Agentic RAG 教程与项目,支持层级索引、对话记忆和查询澄清。
- Star
- 4,268
- Fork
- 587
- 未关闭 Issue
- 0
- 最近提交
- 3天前
这是什么?
Agentic RAG for Dummies 是一个用于学习和二次开发的项目,演示如何用 LangGraph 构建由智能体决定何时、如何检索文档的检索增强生成系统。它既提供可逐步运行的 Notebook 教程,也提供模块化工程,LLM 提供方、嵌入模型、PDF 转换器和智能体流程都可以单独替换。
索引阶段会按 Markdown 标题将文档切分为较大的父块和用于检索的小子块,检索时精确匹配小块,回答时再补充父块上下文。查询阶段,LangGraph 工作流会汇总对话历史、改写含糊或多部分的问题,必要时暂停等待用户澄清。多个并行的智能体子图分别处理each子问题,并包含自我纠错、上下文压缩,以及工具调用和迭代次数的硬性上限。
可运行的应用默认使用 Ollama 运行本地模型,检索层使用 Qdrant,支持稠密向量与 BM25 稀疏向量的混合检索。项目同时给出 OpenAI、Anthropic 和 Google 模型的示例,并介绍了 Langfuse 可观测性和基于 RAGAS 的评估方法。
核心功能
- 01层级索引:用小子块检索,返回更大的父块作为上下文。
- 02查询改写与澄清,信息不足时会暂停并询问用户。
- 03并行智能体子图,将复杂问题拆分为多个子查询。
- 04自我纠错:初次检索结果不足时自动重新检索。
- 05上下文压缩与对话摘要,控制提示词长度。
- 06默认支持本地 Ollama 模型,并提供 OpenAI、Anthropic、Google 模型示例。
适用场景
- 学习如何用 LangGraph 组织 Agentic RAG 工作流。
- 基于 PDF 文档快速搭建问答聊天机器人原型。
- 作为自定义 RAG 系统的起点,替换模型或检索层。
- 使用 RAGAS 评估检索和回答质量。
快速上手
- 1
从官网安装 Ollama
- 2
拉取默认本地模型
ollama pull granite4.1:8b - 3
安装笔记本所需的 Python 依赖(按顺序运行教程单元格)
pip install -qU langchain-openai
使用前须知
- 可运行的应用以 Ollama 为先,需要本地模型;低于 8B 的小模型可能产生幻觉或忽略检索指令。
- 使用云端提供商需要自己的 API 密钥,并产生相应费用。
- README 将项目定位为教程,模块化应用若用于生产环境可能需要进行调整。
标签
常见问题
- agentic-rag-for-dummies 是什么?
- 基于 LangGraph 构建的模块化 Agentic RAG 教程与项目,支持层级索引、对话记忆和查询澄清。 Agentic RAG for Dummies 是一个用于学习和二次开发的项目,演示如何用 LangGraph 构建由智能体决定何时、如何检索文档的检索增强生成系统。它既提供可逐步运行的 Notebook 教程,也提供模块化工程,LLM 提供方、嵌入模型、PDF 转换器和智能体流程都可以单独替换。
- agentic-rag-for-dummies 可以免费使用吗?用的什么许可证?
- agentic-rag-for-dummies 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- agentic-rag-for-dummies 还在维护吗?
- 活跃维护中。agentic-rag-for-dummies 最近一次提交是在 2026年10月17日。
- agentic-rag-for-dummies 适合用来做什么?
- 学习如何用 LangGraph 组织 Agentic RAG 工作流。 基于 PDF 文档快速搭建问答聊天机器人原型。 作为自定义 RAG 系统的起点,替换模型或检索层。 使用 RAGAS 评估检索和回答质量。
- agentic-rag-for-dummies 怎么安装和运行?
- 从官网安装 Ollama 拉取默认本地模型: ollama pull granite4.1:8b 安装笔记本所需的 Python 依赖(按顺序运行教程单元格): pip install -qU langchain-openai
- 在哪里获取 agentic-rag-for-dummies?
- 源代码和安装说明在 GitHub 上:https://github.com/GiovanniPasq/agentic-rag-for-dummies
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
基于 LangGraph 的 Python 库与可运行教程,实现了 35 种智能体 AI 架构,涵盖反思、检索增强、记忆与多智能体等模式。
为 AI 智能体和应用提供长期记忆层,跨会话保存并检索用户与上下文信息。
面向 AI 智能体的记忆系统,支持存储、检索与反思记忆,让智能体随时间学习而非仅回放对话历史。
基于 Ollama 或 LM Studio 本地大模型运行的网络研究助手,迭代搜索、总结并生成带引用的报告。
面向 AI 智能体的开源长期记忆层,通过 Python SDK、REST API 和 MCP 服务器跨会话存储与召回信息。