Repolode
GiovanniPasq

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. 1

    从官网安装 Ollama

  2. 2

    拉取默认本地模型

    ollama pull granite4.1:8b
  3. 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 数据每日更新。

相关项目