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

把上下文当缓存来管:前缀稳定与命中率

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

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

动态信息放前缀 = 永远不命中。

上下文也是"缓存"

多轮对话里,每轮都要重发历史 ✔ —— 这是最大的成本与延迟来源之一 ✔。

现代模型服务普遍支持前缀缓存 ✔(相同前缀命中缓存后,计费与延迟都显著降低 ✔)。

把上下文按缓存的思路管理 ✔:让前缀稳定、把变化放后面 ✔。

一、前缀缓存的基本规律

· 前缀稳定 → 命中率高 ✔(系统提示、工具说明、示例放最前 ✔);

· 变化内容放后面 ✔(用户输入、检索片段、时间戳放尾部 ✔);

· 时间戳/随机 id 会破坏缓存 ✗(放在前缀里 = 永远不命中 ✔)。

这条最容易踩 ✗→✔:在系统提示里写"当前时间:{{now}}" ✔,

会让每次请求的前缀都不同 ✔ —— 缓存命中率直接归零 ✔。

二、四个落地技巧

1. 把动态信息移到末尾 ✔(时间、用户信息、检索结果 ✔);

2. 固定顺序(工具说明、示例、约束的顺序别乱改 ✔ —— 顺序变了前缀也变了 ✔);

3. 长文档前置复用(多轮里反复用同一份文档 → 放在前缀位置 ✔);

4. 观测命中率(没有指标就不知道有没有生效 ✔)。

三、该观测的三个指标

· 前缀缓存命中率(按功能看 ✔ —— 突然下降说明有人往前缀里加了动态内容 ✔);

· 单位成本变化(命中率上升通常成本显著下降 ✔);

· 首 token 延迟(缓存命中会明显更快 ✔)。

四、三个常见坑

· 把时间戳写进系统提示 ✗(最常见的命中率杀手 ✔);

· 每轮重排提示结构 ✗(动态拼装顺序不一致 ✔);

· 把检索片段放前缀 ✗(每轮都不同 ✔)→ 应放尾部 ✔。

五、检查清单

```

□ 系统提示与工具说明在前,内容稳定

□ 时间/用户信息等动态字段在末尾

□ 组装的段落顺序固定

□ 检索片段放尾部(或固定在一个稳定位置之后)

□ 有前缀缓存命中率指标与告警

```

一条判据

> 连续两次请求(内容只改最后一句)✔,第二次的成本与首字延迟是否明显更低 ✔?

> 没有差别,说明缓存没被命中 ✗(大概率前缀里有动态内容 ✔)。

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

相关文章

顺序阅读

← 上一篇:AI 项目的团队分工:谁负责提示词、谁负责评测
下一篇:把踩过的坑固化成边界用例库 →

第 135 / 171 篇

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

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