第 31 课教师讲稿｜搭一个能回查原文的小知识库问答

本课在 AIPath 的第 6 阶段，沿用原课主题“实战 RAG：搭建你的私人知识库”。建议 60 分钟，一人一台电脑。先预测、再手算一个中间结果，最后操作页面。网站中的宏大问题在本课缩小为一个可重复的小过程；课堂程序只承担下文写明的计算，不代表真实产品的完整行为。

学完能做什么

• 能管理四条资料的版本、索引与片段 ID，真实检索并核对命中原文。
• 能把完整证据提示交给已有工具生成并保留记录；不可运行时准确标记手工后备。
• 能逐句核验条件与引用，分别定位旧版本、检索缺失和生成外推错误。

贯穿问题：资料检索、把资料交给模型、核验回答，怎样形成可复查的闭环？

课前准备与完整实验材料

教师先在本课页面找到“规则资料检索与可复制的证据提示”，核对输入框初始值。核心按钮名为“计算并查看过程”。请先自行完成默认、改变条件、独立题三次运行，确认本机能看到过程表；本地运算不需要账号或联网。初次投影时不要留着上一轮结果，让学生先在工作纸写预测。课堂使用学生工作纸，讲評再打开参考答案，避免学生边看答案边回填。

真实本地词项检索、版本过滤与提示组装；真实生成需要学生把完整提示交给自己已可用的对话工具。页面不会外发资料，也没有生成 AI 答案。

• 要问资料的问题（输入框 question）初始为：

学生同时可以借几件，可以借几天？

• 版本筛选（输入框 activeOnly）初始为：

yes

• 最多取几个有命中词的片段（输入框 topk）初始为：

2

• 资料库 JSON（输入框 documents）初始为：

[{"id":"D1","active":false,"tags":["学生","数量","借期"],"text":"旧版，不再启用：学生同时1件，最多2天。"},{"id":"D2-1","active":true,"tags":["学生","数量","借期"],"text":"当前有效：学生同时最多2件，借期最多3天。"},{"id":"D2-2","active":true,"tags":["续借","提前","批准"],"text":"当前有效：续借须提前1天申请，能否批准需值班人员确认。"},{"id":"D2-3","active":true,"tags":["工作日","周末","时间","费用"],"text":"当前有效：工作日办理时间16:30—18:00；周末安排与费用未提供。"}]

课前教师先逐条核对 ID 与 active。标签是人为维护的检索索引，正文变化时标签也需检查。当前后备不等同使用嵌入模型的完整 RAG，但能验证同一批资料、条件与引用。 真实工具路径无需绑定某品牌：使用已经能正常对话的账号，在新对话粘贴完整提示、提交、保存原输出。若现有工具支持文档导入可作为课后扩展，主课堂先用完整短文本以便核对实际输入。

0—60 分钟：可以顺着使用的讲稿

0—4 分钟｜把已有零件接成一条链

教师可以这样说：“前面学过检索、切块与条件核验，今天把它们连起来完成一个小知识库任务。目标不是看到一段流畅回答，而是能回查用了哪版资料、命中哪条、传给模型什么，以及最终哪些句子有支持。”

学生具体动作。 Q1 画资料→检索→提示→回答→核验五格。

教师在桌边怎样追问。 哪一格失败会让后面再流畅也答错？

本段要收集的证据。 五格各有可留下的记录。

4—8 分钟｜先把资料版本读完

教师可以这样说：“库里故意放一份旧版 D1 与三份当前条款。有效字段是我们管理资料的标记，不让模型从最后答案反猜版本。数量、续借、办理时间分成不同片段，ID 以后承担引用定位。”

学生具体动作。 Q2 逐条读四份资料，标有效状态与适用对象。

教师在桌边怎样追问。 旧版数字虽完整，是否仍能直接用于当前回答？

本段要收集的证据。 版本、人群、限制条件被标出。

8—12 分钟｜看清这个检索器怎样找

教师可以这样说：“本页用人工标签与少量词项映射计算命中数，例如几件映射数量。它真的执行筛选排序，却不是神经嵌入检索。标签是否贴得恰当仍需人工管理，不能把命中分数称为语义理解准确率。”

学生具体动作。 Q2 先预测默认问题命中哪个 ID 和标签。

教师在桌边怎样追问。 问题中的哪几个词会参与这里的规则匹配？

本段要收集的证据。 预期命中附具体词项。

12—16 分钟｜先检索再读原文

教师可以这样说：“运行后先看 ID 与原文，不急着复制提示。检查学生、最多、三天这些条件有没有完整保留。若只取到一条标题没有完整规则，应先修资料或检索，不能要求生成模型凭空补齐。”

学生具体动作。 Q2 运行默认问题，抄命中原文并做条件检查。

教师在桌边怎样追问。 命中片段是否真的回答几件与几天两个部分？

本段要收集的证据。 两个子问题各有原文支持。

16—20 分钟｜看组装提示而不是只看按钮

教师可以这样说：“页面已把问题与命中片段装进完整提示，保留 ID、版本和不要编造的要求。请学生亲眼读一遍将要交给模型的全部文字。输入有错误时，不能把所有责任归到生成步骤。”

学生具体动作。 Q2 标出完整提示的问题、资料、回答约束三部分。

教师在桌边怎样追问。 实际传入的文字与资料库里你以为的文字一致吗？

本段要收集的证据。 生成前输入可回查。

20—24 分钟｜在已有工具中真实生成

教师可以这样说：“打开自己已有可用的对话工具，开始一段新对话，把本页完整提示原样粘贴后提交。记录工具名称、日期、输入和完整输出。不要求购买新订阅；这一步由实际运行完成，网页本地检索本身没有调用模型。”

学生具体动作。 Q3 复制提示到现有工具，保存真实输出；不能运行者手工作答并标注。

教师在桌边怎样追问。 保存的是实际输出，还是老师预先写好的参考答案？

本段要收集的证据。 生成状态与原始输出完整。

24—28 分钟｜逐句回查而非只看引用外观

教师可以这样说：“给答案每一句标原文支持。带着 D2-1 的引用也可能把两件说成三件，所以引用存在与引用支持内容是两次检查。数值、人群、例外都要逐项比，不能让漂亮方括号代替阅读。”

学生具体动作。 Q3 把数量与借期各指回来源的具体词句。

教师在桌边怎样追问。 引用 ID 正确，但句子内容是否也与原文一致？

本段要收集的证据。 结论—片段—原句三项对应。

28—32 分钟｜故意关掉版本过滤

教师可以这样说：“先只把有效筛选改为包含旧版，片段数仍为二，记录新旧版本是否一起命中。接着保留这轮条件，只把最多片段改为一，再看留下哪一条。旧版和新版标签一样时，固定顺序可能把旧版排前。两次各改一个条件，才能分别观察版本过滤和截取数量的影响。”

学生具体动作。 Q3 对照版本过滤前后命中，不把反例提示发给真实用户。

教师在桌边怎样追问。 错误已经在检索阶段出现还是生成阶段出现？

本段要收集的证据。 错误阶段定位有命中证据。

32—36 分钟｜让没有资料时能够停住

教师可以这样说：“问库里没有的天气问题，页面应无命中。可以说明资料不足，而不是生成一个看似合理的天气结论。真实嵌入模型可能仍返相近项，也需要相应无答案检查，不能因为有返回就说能答。”

学生具体动作。 记录一次无命中，并写应给用户的有限回复。

教师在桌边怎样追问。 返回空结果是不是可以诚实交付的一种情况？

本段要收集的证据。 资料不足状态未被编造成答案。

36—40 分钟｜独立续借问题

教师可以这样说：“Q4 恢复只用有效资料，问题换成提前一天申请是否一定批准。先写自己的判断与需要查找的证据，再运行检索。请把结论指回原文的具体词句，并保留第一次回答；独立结束后再讲评。”

学生具体动作。 Q4 检索续借问题，保存命中与提示。

教师在桌边怎样追问。 申请条件与审批结果是不是同一个事实？

本段要收集的证据。 申请与批准条件分别标明。

40—44 分钟｜独立周末问题

教师可以这样说：“接着问周末十七点能否办理，先不看答案。自行确定需要核查哪些条件，记录检索命中与支持结论的原句。若工具可用，分别实际生成；不能用时按同一原文写手工答复并保留标记。暂不交流最终判断。”

学生具体动作。 Q4 检索周末问题，完成真实或手工答复并标状态。

教师在桌边怎样追问。 十七点落在某时段内，是否就满足工作日条件？

本段要收集的证据。 时刻与日期两类条件同时核对。

44—48 分钟｜同伴查找两处越界

教师可以这样说：“给同伴一段构造错答：续借一定批准、每天都在该时段办理。要求逐句找来源中的反证或缺失，不以语气好不好判断。此处错误句是教学卡，不是我们声称实际工具生成过的记录。”

学生具体动作。 Q5 对构造错答逐句标越界条件。

教师在桌边怎样追问。 哪一句把有限日期范围扩大成每天？

本段要收集的证据。 两处错误各有原文对照。

48—52 分钟｜此时讲评独立答案

教师可以这样说：“续借据 D2-2 需要值班确认，不能保证批准；周末据 D2-3 没有提供安排，不能把工作日规则套过去。真实工具若回答不同，要保留原输出再修提示或资料，不能修改日志假装第一轮成功。”

学生具体动作。 修订 Q4，并给每句结论附对应 ID。

教师在桌边怎样追问。 你记录的是首次结果还是改过后的结果？

本段要收集的证据。 原始失败与修订结果分开。

52—56 分钟｜选一个自己的微型知识库

教师可以这样说：“Q6 选公开社团规则或自己可分享的课程说明，先只放三到五段并为每段编号。不要一开始把全部私密聊天传进去。定义两个有答案问题和一个无答案问题，就能检验闭环是否真的工作。”

学生具体动作。 Q6 写自选资料范围、三问题和核验计划。

教师在桌边怎样追问。 资料是否允许使用，问题是否超出资料范围？

本段要收集的证据。 小范围资料和可核查问题集。

56—60 分钟｜离堂按五段证据交付

教师可以这样说：“最后交检索命中、完整提示、实际输出或手工标记、逐句引用核对、未通过项。即使尚无实际模型输出，仍可交付完成的检索与组装，但要明确哪一段还没执行，不能笼统写系统已跑通。”

学生具体动作。 Q6 按五段证据整理一次闭环状态。

教师在桌边怎样追问。 有没有把本地后备误写成完整神经 RAG？

本段要收集的证据。 完成阶段与剩余问题清楚。

教师的概念备查：先用上面的观察，再补准确说法

这部分供备课和讲评时查阅，不要求在第一分钟连续宣读。学生已经看到一个过程后，再用相应名称为过程命名。需要回答更深问题时，先说明小实验所固定的条件，避免从一个算例直接跳到所有大模型。

建库与每次问答

建库把文档整理成可检索单位并记录来源、版本和表示；问答把当前问题转成检索请求，选片段再生成。两阶段分开有助于复用索引和定位错误。文档更新时需要更新相关片段与索引，不能说建库永久只做一次。本课只有少量段落，代码为透明起见在运行时重建小型表示；正式复用可另加缓存，但不能把演示便利性当大型系统最佳结构。

可以补充的例子：D1旧规则不再active，D2-1/2/3分别记录数量、续借和办理时间。

应当停住的推论：RAG不限于向量检索，索引更新也不是无成本。

片段与来源标识

片段决定一次检索取回多少信息。切得过碎可能丢条件，过大则混入不相关主题；理想边界需要结合文档结构和任务验证。本例按完整条款保留D2-2的申请条件和人工批准，避免把半句变成保证。来源ID和版本必须跟随文本一起走到答案，方便回查旧规则、冲突与新更正，而不只是给结果装一个引用样式。

可以补充的例子：“提前1天申请”和“是否批准由值班确认”在同一条款。

应当停住的推论：固定300字或重叠50字只是可能起点，不是对所有资料最优。

嵌入与检索排序

神经嵌入把文本映射到向量，问题与片段需要使用兼容表示后比较相关性。本课实际使用预设词项映射与标签命中计数：“几件”补充“数量”，“几天”补充“借期”，再统计每段资料有几个不同标签出现在扩展后的问题里。程序先按有效状态过滤，只保留命中数大于零的片段，再按命中数降序、并列原顺序取前 k 条；没有调用嵌入模型，也没有计算余弦相似度。以后换成神经检索时，应使用兼容的查询与文档编码方式，并仍打印命中原文核验，不把相似度当事实正确概率。

可以补充的例子：问同时借几件时应找到D2-1；只找到办理时间就先查检索，而不是先改生成语气。

应当停住的推论：不同嵌入模型的向量不能仅因维度相同就直接比较。

上下文组装与生成

取回片段后，要把任务要求、来源文本与问题组织成模型能使用的输入。要求只依材料和标引用有助于核查，但不能保证模型绝不编造。本页显示完整提示，停在检索与组装，不提供模型回答字段。学生把这份提示提交给已可用对话工具后，保存实际输入输出，并据原文逐句检查，就完成了本课手动衔接的“检索—生成—核验”任务。没有调用时只能记录本地检索完成和手工参考，不能记成真实生成。RAG 可以使用词项检索，并不要求必须调用嵌入模型；进一步自动连接接口属于课后扩展。

可以补充的例子：传入D2-3后问周末，材料写未提供，最终答案应保留未知。

应当停住的推论：打印提示不是生成；模型回复写“已检索”也不证明真实检索发生。

错误定位与证据

面对错误答案，先看检索到了什么，再看实际提示包含什么，最后看答案如何使用它们。没有命中相关段是检索问题；段落被截断是材料或组装问题；已含限制却答反是生成使用问题。一个问题可同时有多个原因，修订后要保留原题回归与新题检查。用这种分层日志，小应用和报告能保留可解释来源，也能避免靠多写“准确”掩盖管线错误。

可以补充的例子：申请段已完整传入而答案说保证续借，是引用支持失败；费用未命中时应补资料而非编金额。

应当停住的推论：可运行三题原型不等于可上线处理任意私人文档。

后置讲评：独立尝试结束后才展开

Q2 仅当前有效资料时默认命中 D2-1，回答学生同时最多2件、借期最多3天，并引用[D2-1]。规则标签匹配不是神经嵌入。Q3 关闭版本过滤且只取一条时，旧 D1 可按并列原顺序被选中，说明错误在生成前已出现。天气应无相关命中，不应编造天气。

真实工具输出不设唯一字符串，按数值、条件、引用支持、无编造四项验收；需保存实际原始输出。无外部工具时手工参考不能标真实生成。Q4 A 应命中 D2-2，提前申请不保证批准；B 应命中 D2-3，周末未提供，工作日时段不能外推。示例：续借须提前1天申请，是否批准需值班确认[D2-2]；资料只规定工作日办理时段，周末安排未提供[D2-3]。

Q5 错答一把申请条件当作结果保证，二把工作日扩大为每天。Q6 选公开或有权使用的小材料，为片段编号，问题与标准先固定，再保留命中、提示、输出状态、引用核对及失败清单。完成检索不自动证明生成质量；课堂检查不等于生产系统验收。

板书、补救与课后加深

• 资料版本 → 命中片段 → 完整提示 → 实际输出 → 逐句核验。
• 检索失败与生成失败分开定位。
• 每句结论有 ID、有原句、有适用条件。

使用本页相同的输入、步骤与判定规则在纸上完成，必要时用普通计算器。保留预测、中间量和最后核对，注明实际完成的是纸面复算。没有外部 AI 调用，不把这项工作说成已经得到某个产品的真实效果。

增加索引持久化、真实文档更新和一组新材料评测；完整代码部署与私人资料管理另定深度。 深化内容另计时间；先保证本课独立练习完成。

来源和实际完成范围

• AIPath 对应课：用作课序与主题对应。
• RAG原始论文：核对检索记忆与生成结合的基本思路。
• Ollama嵌入接口：核对同模型批量文本编码、embeddings和截断设置。
• Ollama聊天接口：核对生成请求及最终内容字段。

新增实验在浏览器本地计算，已用随课测试核对指定条件。纸面样本是为解释机制编写的，不是实际业务数据；未在此训练大模型，未做真人试教。