选型指南 架构设计 含可复制代码

检索与生成的分工契约:谁负责什么

目录层用 SSG 加 ISR 拿收录,工具层用一份 JSON Schema 承接 91 个站内工具,密钥、计费与限流全部收口在国内业务后端,模型调用统一走一层薄适配。这篇把我们真实的目录结构、Schema 字段定义、路由闸门、预扣结算伪代码和合规清单完整摊开。

陈
陈默架构组
2026-09-28 · 14 分钟阅读 · 8,432 次浏览

拿一个错误答案,能否在 10 分钟内说出该改哪一侧?

检索与生成的"分工"要写下来

RAG 系统里最常见的一类扯皮 ✗:答案错了,检索团队说"片段给对了,是模型没用好" ✗,

生成团队说"片段里没有关键信息,模型当然答不出" ✗。没有分工契约,就无法归因 ✔。

把分工写成契约 ✔:谁负责什么、交付什么格式、失败时算谁的问题 ✔。

一、检索侧的三项承诺

1. 召回承诺:该命中的片段必须进候选集(用召回率指标约束 ✔);

2. 排序承诺:正确片段进入前 K(用命中位次/MRR 约束 ✔);

3. 交付格式承诺:每个片段带来源、时间、原文片段、块 id ✔(生成侧要用来引用 ✔)。

交付格式很关键 ✗:如果检索只给一段裸文本 ✔,生成侧无法引用、无法判断时效 ✔(见片段预处理那篇 ✔)。

二、生成侧的三项承诺

1. 只用给定片段(不允许引入未提供的事实 ✔);

2. 标注引用(每条结论对应片段 id ✔);

3. 资料不足时明确说明(不编 ✔,见拒答那篇 ✔)。

三、失败归因规则(写下来就不吵了)

| 现象 | 归因 | 先改哪边 |

|---|---|---|

| 正确片段没进候选集 | 检索(召回 ✔) | 切分/解析/索引 ✔ |

| 正确片段进了但排太后 | 检索(排序 ✔) | 排序信号/去重 ✔ |

| 片段对但答案错 | 生成 ✔ | 提示词/示例/引用要求 ✔ |

| 答案对但没引用 | 生成 ✔ | 引用格式与校验 ✔ |

| 片段不足却给答案 | 生成 ✔(应拒答 ✔) | 拒答标准与判据 ✔ |

| 片段互相矛盾 | 两边 ✔ | 检索加时效/权威信号 + 生成说明冲突 ✔ |

关键:这张表要事先定好 ✔,并在复盘时直接引用 ✔ —— 否则每次都要重新吵一遍 ✗。

四、怎么验证契约在生效

· 分段指标(召回/位次/引用率/编造率 ✔)分别看 ✔(见三段评测那篇 ✔);

· 契约测试:构造"检索故意给错片段"的用例 ✔,看生成侧是否会拒答 ✔;

· 反向测试:给对的片段 ✔,看生成侧是否稳定答对 ✔。

五、两个常见反模式

· 把一切归给模型 ✗(于是永远在换模型 ✔);

· 契约只存在于口头 ✗(新人不知道,冲突照旧 ✔)→ 写进交接文档 ✔。

一条判据

> 拿一个错误答案 ✔,能否在 10 分钟内按既定规则说出"该改哪一侧" ✔?

> 不能,说明分工契约还没写清 ✗。

本文由云枢 AI导航整理,内容以官方来源为准。

相关文章

顺序阅读

← 上一篇:把评测做成组织能力:谁来写、谁来跑、谁来读
下一篇:AI 功能的文档怎么写:能力、限制与示例 →

第 77 / 171 篇

术语速查 · 本页出现的 12 个词展开看中文名与一句话解释,点术语看完整条目
  • token词元:模型处理文本的最小单位,中文约 1–2 个汉字;计费与上下文长度都按它算。
  • 转写 / 字幕Transcription:把音视频人声逐句变成带时间戳的文字稿,便于做字幕与章节切分。
  • SSE服务器发送事件:服务器通过长连接持续推送增量文本,是对白逐字出现的常见实现。
  • API应用编程接口:程序之间约定的调用方式;站内工具由服务端调用,浏览器里不出现密钥。
  • CDN内容分发网络:把静态资源缓存到离用户更近的节点,缩短加载时间。
  • 缓存Cache:把结果暂存复用,复用得越多平均耗时越低;需要约定过期与刷新策略。
  • 限流Rate Limit:限制单位时间内的请求次数,防止单用户或异常流量打满服务端。
  • SSG静态站点生成:构建阶段就生成 HTML,访问时直接返回,不必每次请求都渲染。
  • ISR增量静态再生:先返回静态页,再在后台按需重新生成,兼顾速度与更新时效。
  • 灰度发布Canary Release:先让一小部分用户用新版本,确认无误再放量,出问题的爆炸半径最小。
  • 提示词Prompt:交给模型的指令文本;写清角色、任务、输入与输出格式比反复试更省。
  • 积分Credits:站内计费单位:按工具单价预扣,调用失败自动退还;单价以定价页为准。

完整解释与站内出现处见 AI 术语表(40 条)。