RAG 切块与引用定位怎么配置或排查
RAG 出现“能回答但引用不准”,通常不是向量库单独出了问题,而是切块和定位从一开始就没有绑定起来。实用的配置顺序是:先按标题、段落或表格保留语义边界,再用模型的 token 预算控制长度,最后把文档版本、章节和字符区间一并写入每个 chunk。这样检索返回的不只是文本,还能回指到原文位置。
- 切块大小没有通用常数,先保证一个片段围绕一个可回答的小问题。
stride只负责跨边界保留上下文,不能替代结构化切分。- 引用定位至少保存稳定的
doc_id、版本、章节和字符偏移。
先按文档结构确定 RAG 的切块单位
不要一上来按固定字符数截断整篇文档。对产品手册、接口文档和规章制度,更稳妥的顺序是“标题层级 → 段落 → 表格或列表”,再对超长段落做二次切分。每个 chunk 还应带上父级标题,例如“部署 / 环境变量 / 超时设置”,否则向量相似度相近的片段会互相混淆。
起步时可以把单片段预算设在约 300~700 tokens,重叠设为 40~100 tokens;这是待验证的初始值,不是所有模型都适用的标准。短问答可缩小片段,带定义、条件和例外的规范文本则要保留完整小节。切完后抽 20 个真实问题检查:答案所需的定义、条件、结论是否仍在同一片段或相邻片段内。
用 token 预算和 offset 处理长文本
字符数不等于模型 token 数,中文、代码和 URL 的切分比例也不同。以 Hugging Face Transformers 为例,Tokenizer 支持 max_length 控制上限,stride 保留溢出片段的尾部上下文,return_overflowing_tokens 返回溢出片段,快速 Tokenizer 还可用 return_offsets_mapping 得到字符起止位置。
from transformers import AutoTokenizer
# 这里的长度是入库前的片段预算,需给提示词和特殊 token 留余量。
tokenizer = AutoTokenizer.from_pretrained("bert-base-chinese", use_fast=True)
encoded = tokenizer(
text,
max_length=512,
truncation=True,
stride=64,
return_overflowing_tokens=True,
return_offsets_mapping=True,
)
chunks = []
for index, (ids, offsets) in enumerate(zip(encoded["input_ids"], encoded["offset_mapping"])):
# 去掉特殊 token 的无效偏移后,保存片段在原文中的字符范围。
valid = [(start, end) for start, end in offsets if end > start]
if not valid:
continue
start_char, end_char = valid[0][0], valid[-1][1]
chunks.append({
"chunk_index": index,
"text": text[start_char:end_char],
"start_char": start_char,
"end_char": end_char,
})
这段配置只展示切分契约,实际入库前还要补齐标题、文档版本和权限字段。常见排查顺序如下:
| 现象 | 优先检查 | 处理方向 |
|---|---|---|
| 引用总指向段落末尾 | offset 是否来自同一份清洗文本 | 固定清洗版本,禁止重新折叠空白后再定位 |
| 答案缺少前置定义 | chunk 是否从句子中间开始 | 先按标题和段落切,再在段落内按 token 切 |
| 相邻片段内容重复太多 | stride 是否接近片段长度 | 减小重叠,并用真实问题比较召回结果 |

引用定位要绑定稳定坐标,而不是只存一段文本
向量库中的文本可能会被清洗、重排或重新嵌入;如果引用只保存“第 3 条结果”,下一次索引后就可能漂移。建议把下面这些字段作为最小定位元数据:doc_id、doc_version、source_url、section_path、page(有页码时)、start_char、end_char 和稳定的 chunk_id。其中 chunk_id 可由文档 ID、版本和片段序号组成,重建同一版本时不要随机生成。
引用展示时不要让模型凭记忆编造链接。把检索结果包装成带分隔符的证据块,例如 [chunk_id=manual-v3-014],生成提示明确要求“每个事实后引用对应 chunk_id;上下文没有答案时说明证据不足;来源冲突时分别引用”。模型返回后,应用层再根据 chunk_id 查元数据生成可点击的原文链接或页码高亮。引用格式由应用层落地,可靠性会高于单靠提示词。

把检索结果和生成门禁连成一条链
排查时要分清三个层次:切块是否完整,检索是否召回,生成是否正确引用。先对固定问题记录 top-k 的 chunk_id、相似度和过滤条件,再看答案中的每个结论是否能在返回片段中找到原句。只改 prompt 而不检查召回片段,往往只能让措辞更像引用,不能修复漏召回。
如果正文有权限边界,还要在检索前执行租户或文档权限过滤,并把权限版本纳入重建策略。文档更新时生成新 doc_version,旧版本可以保留用于审计,但不要让新旧版本无条件混排。Hugging Face 的 RAG 文档展示了检索文档、文档得分和上下文输入等对象;微软的 RAG 指南也强调把标题、章节和来源 URL 随 chunk 传入上下文,这正是引用能稳定落地的基础。
常见问题
chunk 越大,回答是不是越完整?
不一定。过大会稀释相似度并挤占上下文,过小又会切断定义和条件。先按结构切分,再用真实问题比较召回和引用覆盖率。
只保存 page 和 chunk_index 够不够?
对固定版 PDF 可能够用;网页、Markdown 或会频繁更新的文档还应保存版本和字符偏移,否则页面重排后无法精确复查。
引用错误一定是 embedding 模型的问题吗?
不是。先检查清洗文本、切块边界、过滤条件和 top-k 结果,再判断是否需要更换 embedding 或增加关键词检索。
官方资料:https://huggingface.co/docs/transformers/main/model_doc/rag
Go assert 出错时怎么查断言失败
- 上一篇
- Go assert 出错时怎么查断言失败
- 下一篇
- Lovart灵感与技能管理如何提高效率?可复用的操作流程
-
- 科技周边 · 人工智能 | 1小时前 |
- 检索结果重复时如何做去重和来源合并
- 484浏览 收藏
-
- 科技周边 · 人工智能 | 3小时前 |
- AI 生成代码如何用单元测试约束修改范围
- 366浏览 收藏
-
- 科技周边 · 人工智能 | 4小时前 |
- 提示词模板如何给变量设置默认值和类型
- 296浏览 收藏
-
- 科技周边 · 人工智能 | 5小时前 |
- 流式输出中断后如何恢复未完成的模型响应
- 108浏览 收藏
-
- 科技周边 · 人工智能 | 6小时前 | 上下文 · 人工智能 · ai agent · rag · AI Agent agent memory 记忆系统
- AI Agent 记忆如何区分用户事实和临时对话
- 110浏览 收藏
-
- 科技周边 · 人工智能 | 13小时前 | API · 错误处理 · 人工智能 · 工程实践 · 函数调用 · 参数校验 工具调用 Function Calling 幂等重试 strict Schema
- 工具调用参数校验失败后怎样安全重试
- 215浏览 收藏
-
- 科技周边 · 人工智能 | 14小时前 | API · 人工智能 · json schema · 结构化输出 · 排错 · enum 结构化输出 JSON Schema 模型API 响应校验
- 结构化输出如何处理模型返回的枚举值错误
- 345浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 110次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 24次使用
-
- OpenCompass
- OpenCompass是上海AI实验室推出的开源大模型评测平台,提供CompassKit、CompassHub和CompassRank三大核心组件,支持LLM及多模态模型的一站式标准化评估与排行榜查询。
- 44次使用
-
- AGI-Eval
- AGI-Eval是由上海交大等高校联合发布的大模型评测社区,提供公正透明的LLM能力榜单、多领域评测集及Data Studio数据服务,助力AI模型性能评估与NLP科研开发。
- 23次使用
-
- SuperCLUE
- SuperCLUE是权威的中文大语言模型综合评测基准,涵盖语言理解、知识应用、AI Agent智能体及安全性等12项核心能力。通过多轮对话与客观测试,定期发布榜单与技术报告,为模型研发、优化及行业选型提供科学依据。
- 264次使用
-
- RAG 召回评估实战:用向量检索和重排序减少答非所问
- 2026-06-12 174浏览
-
- AI 知识库分块实战:按标题层级切文档,减少回答跑偏
- 2026-06-13 101浏览
-
- AI 知识库回答跑偏怎么办:RAG 检索、重排和引用检查完整流程
- 2026-06-16 419浏览
-
- AI 知识库检索不到答案排查:从分块到重排的 RAG 修复流程
- 2026-06-17 453浏览
-
- AI 知识库检索召回工作流:从文档切分到重排和证据引用
- 2026-06-20 191浏览

