agent-rag">一、选型背景:为什么让 Agent 读报告绕不开 RAG
工程试验场景有一个典型的矛盾:资料在本地越攒越多,AI 能“看进去”的却很有限。以一个微电机试验项目为例,一年积累 300 多份检测报告,版式文档、文字文档、表格三类格式混存,每份 20 到 60 页,包含转速点、温度曲线、振动数据、寿命统计和大量图表。业务上要回答的是“哪几个转速点最容易出异常”“哪类样件在 3600 转段振动普遍偏高”这类跨报告的聚合、对比与归因问题——靠人翻报告要以周计,直接把报告丢给大模型也不可行。
不可行的原因有两个,都是选型时必须正视的客观约束:
- 上下文窗口限制:模型单次可处理的文本长度有上限,300 份报告、每份几十页,光页数就能把窗口撑爆;
- 长文本注意力衰减:即使勉强装下,模型对长文本中后段的注意力衰减是客观存在的,位置越靠后读得越不准,结论可靠性随之下降。
RAG(Retrieval-Augmented Generation,检索增强生成)针对的正是这两个约束:AI 出结论前,先从资料库检索最相关的片段,再基于片段作答并标注引用来源。它把“读全文”换成“按需检索”,模型只处理最相关的 top-K 片段——窗口不爆、注意力集中,且结论有出处、可追溯、可复核。
所以真正的选型问题不是“要不要 RAG”,而是:分块怎么切、向量模型选哪类、向量库选哪种形态、检索参数怎么定、检索能力怎么挂到 Agent 上、部署在本地还是云端。下面逐项展开。
二、需求拆解:选型前先回答六个问题
选型不是“哪个方案更好”,而是“哪个方案更匹配当前条件”。动手之前,建议先把以下六个问题想清楚:
- 业务目标:是让 Agent 能回答跨报告的归因、对比、统计类问题,还是只做单份报告的摘要问答?前者对检索召回完整性要求高得多;
- 文档规模与格式:数百份、数万块量级,还是数十万块量级?版式文档、文字文档、表格占比如何?是否存在扫描件?
- 查询特征:问题是否需要精确到“哪份报告、哪一页、哪个转速段”?这决定可追溯性的实现优先级;
- 安全合规:试验报告多含研发敏感数据,“数据不出内网”是否是硬性前提?
- 成本预算:一次性索引构建成本、持续查询的算力成本、以及最容易被低估的调参与维护人力成本;
- 增长预期:报告逐年累积,索引能否增量更新,直接决定方案的生命周期。
三、选型对象:RAG 链路上的五个决策点
一套面向 Agent 的本地 RAG,通常由五个可独立决策的环节组成。
1. 分块策略:决定检索粒度
- 固定长度分块:实现简单,但会把完整的试验段落切碎;
- 按文档结构分块:例如按“报告标题 + 转速段/温度区间”切块,语义完整度更高,命中后更能直接支撑结论;
- 块大小是核心权衡:块太大,检索不精准且浪费模型窗口;块太小,上下文断裂、引用信息丢失。工程实践中,“每块 512 字以内”是中小规模技术文档的常见起点,最终应通过测试集校准。
2. 向量模型:决定语义匹配能力
- 本地开源小模型:数据不出域、无按次调用成本,多语言场景可选社区维护的轻量多语言模型,本地推理即可运行;
- 云端向量接口:语义能力通常更强、无需自行维护,但文本要出域,且按用量计费;
- 选择依据首先是数据合规要求,其次才是效果差异。注意:更换向量模型意味着全量重建索引,选型时要预判这一迁移成本。
3. 向量数据库:决定规模上限与运维负担
- 嵌入式本地库:以单文件形式存在,零部署、零运维,适合中小语料(参考案例:4.2 万个块,本地库文件约 800MB);
- 独立向量服务:支持更大规模、并发与多应用共享,但需要部署和专人运维;
- 云托管向量/知识库服务:索引构建、检索调度由平台托管,例如百度智能云提供的向量数据库与知识库检索类服务,适合希望低运维且允许数据上云的团队。
4. 检索策略:决定答案质量
- top-K 取值:K 太小容易漏证据,K 太大引入噪声、挤占窗口,top-5 是常见基线;
- 相似度度量:余弦相似度是文本向量检索的主流选择;
- 元数据过滤:分块时保留报告编号、章节、转速段、日期等元数据,检索时可先过滤后排序,对“只看某年报告”“只看某转速段”类问题提升明显。
5. Agent 接入方式:决定模型能否自主用起来
推荐把检索能力封装成独立工具,通过标准化的工具接入协议注册给 Agent,让模型根据问题自主决定是否调用、如何调用。配置示意如下(字段以所用 Agent 框架文档为准):
{ "servers": { "local_kb": { "type": "stdio", "command": "<本地检索服务启动命令>", "args": ["<检索服务脚本路径>"] } }}
首次接入需要先全量建库,把报告批量喂进去,示意命令:
<索引构建脚本> --input ./reports/ --chunk-size 512
四、核心评估维度:怎么判断一套方案“够用”
- 检索质量(最优先):RAG 的答案质量上限由检索决定。用“问题—应命中文档”的标注集验证 top-K 命中率;命中不达标时,优先调整分块策略,其次再考虑更换向量模型;
- 可追溯性:答案能否落到“哪份报告、哪一页、哪个转速段”。这决定了结论能否被工程师复核,是研发场景的硬要求;
- 性能:关注两个指标——索引构建耗时与查询延迟。数万块规模下,本地嵌入式库通常能满足交互式问答;语料涨到数十万块以上时,再评估独立服务或托管方案;
- 安全性:数据驻留位置、访问控制、操作审计。试验报告多含研发敏感数据,“本地推理、数据不上云”常是先决条件;
- 扩展性:是否支持增量更新(新报告只索引增量而非全量重建)、向量模型更换后的重建成本、语料增长后的平滑迁移路径;
- 运维复杂度:备份恢复、索引重建、异常排查的难度。嵌入式库几乎无运维,独立服务需要专人负责;
- 成本结构:存储成本(可参考 4.2 万块约 800MB 的量级估算)、本地算力或云端调用费用、以及持续的调参维护人力。
五、方案适配分析:什么条件选什么形态
- 优先选择“本地嵌入式向量库 + 本地开源向量模型”的条件:数据敏感不允许出域;语料在数万到十几万块量级;团队有基本开发能力但无专职运维。这也是试验报告、内部研发文档类场景最常见的起点;
- 优先选择“本地独立向量服务”的条件:语料规模大、增长快;多个应用需要共享同一知识库;团队具备部署与运维能力;
- 优先选择“云托管向量/知识库服务”的条件:允许数据上云;希望把索引构建、检索调度、扩容交给平台,团队专注业务问题本身。评估时重点确认数据驻留区域、访问控制与计费模式;
- 谨慎直接上 RAG 的条件:文档以扫描图片为主且缺少解析与文字识别环节时,纯向量检索效果有限,应先解决文本化问题;查询以复杂统计计算为主时,RAG 负责定位证据,具体计算仍需工具或人工复核。
汇总对比:
| 评估维度 |
本地嵌入式向量库 |
本地独立向量服务 |
云托管向量/知识库服务 |
| 数据驻留 |
完全本地 |
完全本地 |
数据在云端 |
| 部署与运维 |
极低,单文件即可 |
中等,需部署维护 |
低,平台托管 |
| 适合规模 |
数万至十几万块 |
数十万块以上 |
弹性,视服务而定 |
| 成本结构 |
本地算力+人力 |
服务器+专职运维 |
按用量计费 |
| 团队要求 |
有开发能力即可 |
需运维能力 |
以开发接入为主 |
| 典型场景 |
试验报告、内部文档 |
企业级多应用知识库 |
快速上线、低运维诉求 |
六、决策路径:七步从需求到方案
- 确认数据边界:报告能否出域?不能出域直接锁定本地方案;
- 盘点文档形态:格式是否可解析、扫描件占比,决定是否需要前置解析环节;
- 估算规模:块数量级决定嵌入式库还是独立服务;
- 确定基线参数:如 512 字分块、top-5、余弦相似度,先跑起来再调优;
- 小规模试建:先拿几十份报告建索引,验证检索质量;
- 接入 Agent 端到端验证:用真实业务问题检验“检索—生成—引用”全链路;
- 规划增量与备份:确认新报告的增量索引方式与库文件备份策略,再转入日常运行。
七、验证方法:用测试集降低选型风险
- 建立金标问题集:从业务方收集 20~50 个真实问题(如“哪几个转速点最容易出异常”),人工标注应命中的报告与段落;
- 检索命中测试:统计 top-K 命中率与排序质量,未达标先调分块、再换模型;
- 引用一致性抽查:核对答案中的引用是否与原文一致,防止“张冠李戴”;
- 端到端业务复核:让 Agent 实际回答聚合类问题,由试验工程师复核结论可信度;
- 增量与异常演练:模拟新增报告后的增量索引,验证“检索不到”时 Agent 是否明确告知而非编造。
八、落地注意事项
- 元数据先行:分块时就带上报告编号、章节、转速段、日期等元数据,后补成本极高;
- 增量更新机制:新报告只索引增量,避免每次全量重建;
- 模型版本管理:更换向量模型需全量重建索引,提前规划停机窗口;
- 权限与数据治理:明确哪些报告可入库、谁能通过 Agent 查询,保留检索日志便于审计;
- 兜底策略:检索无命中时,要求明确回复“未在知识库中找到依据”,而不是让模型自由发挥;
- 持续监控:关注检索命中率、空结果率、引用完整率,作为知识库质量的长期指标。
九、总结
围绕“让 Agent 读懂海量检测报告”这个目标,选型的核心判断可以归纳为四句话:
- 合规定边界:数据能否出域,决定了本地与云端方案的分野;
- 规模定形态:块数量级决定嵌入式库、独立服务还是托管服务;
- 检索定质量:分块策略与检索参数对答案质量的影响,往往大于模型本身的差异;
- 追溯定可信:引用能回溯到报告与页码,是研发场景采纳 AI 结论的前提。
选型不是选“最强的方案”,而是选“与文档规模、团队能力、合规约束最匹配的组合”。按本文的维度拆解、决策路径与验证清单走一遍,多数团队可以在小规模试运行中确认方案是否可落地,再逐步扩展到全量语料。