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

把检索范围交给用户:透明的范围控制

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

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

筛选后无结果要明确提示,不要静默返回空。

用户不知道"它到底查了什么"

检索范围(哪些资料、什么时间、哪个库 ✔)如果不透明 ✗,

用户就无法解释"为什么没查到我想要的那份文档" ✔,只能怀疑系统不行 ✗。

把检索范围"交给用户" ✔:既透明,又可调 ✔。

一、三个层次的范围控制

| 层次 | 形式 | 适合 |

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

| 显示(只读 ✔) | "本次检索了:产品手册、FAQ(近 1 年)" ✔ | 默认,必须有 ✔ |

| 筛选(可调 ✔) | 时间范围、来源、类型(见可筛选检索 ✔) | 高频需求 ✔ |

| 指定(显式选择 ✔) | "只查这份文档 / 这个库" ✔ | 高级用户与调试 ✔ |

第一层不能省 ✗ → 没有它,用户连"它在查什么"都不知道 ✔。

二、显示该怎么写(三要三不要)

要 ✔:

· 说清范围(哪些资料源、时间窗 ✔);

· 说清数量(命中多少条、用了哪几条 ✔ —— 见证据表那篇 ✔);

· 说清未命中("另有 3 条较早的资料未展示" ✔)。

不要 ✗:

· 只写"已检索知识库" ✔(等于没说 ✔);

· 暴露内部实现(索引名、向量维度 ✔);

· 把范围写成免责声明("结果仅供参考" ✔)。

三、筛选与冲突处理

· 筛选后无结果 → 明确提示"当前筛选下没有资料",并给清除筛选入口 ✔(不要静默返回空 ✗);

· 指定范围后仍无答案 → 说明"在该范围内未找到" ✔(而不是偷偷扩大范围 ✗);

· 范围与权限冲突 → 权限优先 ✔,并说明"部分资料因权限未纳入" ✔(见权限模型 ✔)。

四、该观测什么

· 范围调整率(多少用户会去调筛选 ✔ —— 高说明默认范围不合适 ✔);

· "没查到"投诉(多来自范围不透明 ✔);

· 指定范围使用率(高级用户的真实需求 ✔);

· 筛选后零结果率(高说明默认值或筛选项设计有问题 ✔)。

五、一条判据

> 用户问"为什么没查到我上传的那份文档" ✔,他能否自己从界面上看出原因 ✔(如"该文档未在检索范围内" ✔)?

> 不能,说明范围还没有交给用户 ✗。

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

相关文章

顺序阅读

← 上一篇:AI 功能的并发控制:同一用户重复提交怎么办
下一篇:上线前的 AI 安全检查:20 项清单 →

第 141 / 171 篇

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

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