Java RAG 实战(第 6 篇):Markdown 知识库与 RAG
系列导航所属专栏《Java 开发者从零实现 RAG 知识库》学习位置第 6 篇 / 共 12 篇上一篇《第5篇Embedding 与语义检索》下一篇《第7篇使用 Qdrant 保存和检索向量》本篇先不引入向量数据库只用 Markdown、内存向量检索和 qwen3 跑通完整 RAG重点看清检索资料怎样进入 Prompt。完成进度1. 把 Markdown 按二级标题切成 Chunk2. 使用 bge-m3 检索最相关的 Chunk3. 使用阈值过滤无关资料4. 把命中资料和问题组装成 Prompt5. 调用 qwen3 生成资料内回答为什么要学Embedding 和相似度只能找出“哪段文字更相关”还不会直接生成最终答案。RAG 的关键是把检索结果转换成人类可读的 Prompt再让聊天模型严格依据这些资料回答。先使用内存版可以暂时避开数据库配置把注意力集中在完整主链切分、检索、过滤、组装 Prompt 和生成回答。理解这条链路后再引入 Qdrant 才能清楚知道向量数据库替换了哪一部分。第 1 步运行内存版 Markdown RAG在引入向量数据库前先运行03-markdown-rag确认完整 RAG 并不等于 Qdrant。这个模块把知识放在 Java 内存中适合观察每一步的数据怎样流动。示例知识文件位于03-markdown-rag/knowledge/kubernetes.md程序执行顺序MarkdownKnowledgeLoader 读取 Markdown 并按二级标题切成 Chunk ↓ ChunkSearch 用 bge-m3 计算问题与全部 Chunk 的相似度 ↓ RelevantChunkSelector 过滤低于 0.60 的结果并选择 Top-2 ↓ RagPromptBuilder 把命中资料和原始问题组装成 Prompt ↓ OllamaChatClient 调用 qwen3:14b 生成最终回答运行默认问题mvn-f03-markdown-rag/pom.xml compile exec:java也可以传入自己的问题mvn-f03-markdown-rag/pom.xml compile exec:java\-Dexec.args密码、令牌和证书应该保存在哪里成功时会先打印候选 Chunk 和相似度再打印模型回答。这里的候选向量没有保存到数据库因此每次运行都会重新读取 Markdown并重新为全部 Chunk 生成 Embedding。命中资料不是由 Ollama 自动读取的。RagPromptBuilder会在 Java 中组装类似下面的内容System Prompt只能根据提供的知识库资料回答。 User Prompt 知识库资料 [Service Chunk 的标题和正文] 用户问题 Pod 重建后 IP 变化怎样提供稳定访问地址qwen3 看到的是这个 Prompt不是向量。向量只在“找资料”这一步中使用。关键代码检索结果怎样变成模型回答对应源码03-markdown-rag/src/main/java/com/example/ai/rag/MarkdownRagDemo.java 03-markdown-rag/src/main/java/com/example/ai/rag/RagPromptBuilder.javaMarkdownRagDemo先过滤结果没有合格资料时直接返回为了突出主调用链下面片段缩减了日志打印类名、方法和调用顺序与仓库源码一致。ListChunkSearch.ResultrelevantResultsselector.select(results,MIN_SIMILARITY,TOP_K);if(relevantResults.isEmpty()){System.out.println(根据现有资料无法确定。);return;}RagPromptBuilder.PromptpromptnewRagPromptBuilder().build(query,relevantResults,TOP_K);StringanswerchatClient.chat(prompt);RagPromptBuilder再把最多TOP_K条资料按顺序拼接StringBuilderuserPromptnewStringBuilder(知识库资料);intchunkCountMath.min(maxChunks,results.size());for(intindex0;indexchunkCount;index){MarkdownKnowledgeLoader.Chunkchunkresults.get(index).chunk();userPrompt.append(\n\n[资料 ).append(index1).append().append(chunk.title()).append(]\n).append(chunk.content());}userPrompt.append(\n\n用户问题\n).append(query);这是 RAG 中“检索”与“生成”真正接上的位置。前面的relevantResults来自向量检索后面的prompt才会发给 qwen3。运行这一阶段的测试mvn-f03-markdown-rag/pom.xmltest测试覆盖 Markdown 切分、检索排序、阈值过滤、Prompt 组装和 Ollama 请求解析。完成这一步后再把相同知识迁移到 Qdrant就能清楚看到向量数据库究竟替换了哪一段工作。本篇自测RAG 一定需要向量数据库吗bge-m3 和 qwen3 在这条链路中分别做什么qwen3 最终看到的是向量还是 Prompt没有资料达到阈值时为什么不调用聊天模型参考答案不一定小规模资料可以先做内存检索bge-m3 负责向量化和检索qwen3 根据资料生成回答模型看到的是组装后的 Prompt避免基于无关资料回答并减少无效调用。本篇小结完整 RAG 包含加载切分、向量检索、阈值过滤、Prompt 组装和模型生成。向量只用于寻找相关资料真正发送给 qwen3 的是人类可读的 Chunk 正文。内存版适合学习流程但每次运行都会重新计算全部知识向量。下一篇 本专栏下一篇《第7篇使用 Qdrant 保存和检索向量》完整代码都在 GitHub欢迎 Star ⭐本专栏的全部示例代码都已开源包含 5 个可独立运行的 Maven 模块、自动化测试和完整分篇教程。建议Fork / Clone下来边读边跑 https://github.com/bysbsh/ai-rag-learning-guide代码与教程同步更新对照每一篇动手实践效果最好。如果这份教程帮到了你点个Star就是对我最大的支持也方便你之后找回最新版本。遇到问题或发现错漏欢迎在仓库提 Issue / PR。项目采用 MIT 协议可自由学习与二次创作。

相关新闻

继承体系搭好了,方法找不到了

继承体系搭好了,方法找不到了

系列回顾:上一篇毛毛姐叠了三个装饰器,执行顺序全反了——洋葱模型 + 协议覆盖,元编程的两把双刃剑。这一篇,毛毛姐搭了个粉丝管理的多重继承体系,结果方法调用顺序完全不对。 📋 本期坑点速览:多重继承 MRO 顺序反直觉 super() 在闭包中绑定错误类 __name 名称修饰不…

2026/11/20 7:10:25 阅读更多 →
2024年KMS_VL_ALL_AIO激活工具完全指南:3步实现Windows和Office自动续期激活

2024年KMS_VL_ALL_AIO激活工具完全指南:3步实现Windows和Office自动续期激活

2024年KMS_VL_ALL_AIO激活工具完全指南:3步实现Windows和Office自动续期激活 【免费下载链接】KMS_VL_ALL_AIO Smart Activation Script 项目地址: https://gitcode.com/gh_mirrors/km/KMS_VL_ALL_AIO 周一早上,隔壁工位的小王一脸愁容地问我&…

2026/11/20 7:10:25 阅读更多 →
Uniswap V3 AMM核心原理:集中流动性与Tick数学

Uniswap V3 AMM核心原理:集中流动性与Tick数学

Uniswap V3 AMM核心原理:集中流动性与Tick数学 一、引言 Uniswap V3是DeFi史上最重要的创新之一——通过集中流动性(Concentrated Liquidity),LP可以将资金集中在特定价格区间,资本效率比V2提升4000倍。但代价是复杂的数学和LP策略。 二、从V2恒定乘积到V3集中流动性…

2026/11/15 8:41:19 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/19 21:38:27 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/19 21:38:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/19 21:39:09 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/19 21:36:50 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/19 21:37:45 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/19 21:36:20 阅读更多 →

日新闻

周新闻

月新闻