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

影子模式:新版先暗跑,再决定要不要切

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

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

没有一键回滚,就不要全量上线。

直接切换版本的风险

新版提示词/模型上线最危险的做法是直接切 ✗:效果无法对比、出问题无从归因、回滚靠临时改配置 ✗。

影子模式(shadow)就是让新版本在不影响用户的前提下先跑一段。

影子模式的三种形态

1. 双跑对比(最常用):真实请求同时发给新旧两版,只返回旧版结果,新版结果只记录;

2. 离线回放:把历史请求重放给新版,与当时的旧版输出逐条对比(不需要线上流量);

3. 小流量并行:把 1% 流量真实走新版(用户看得见),其余走旧版 —— 这已属灰度,不是严格影子。

双跑对比最适合高风险改动(提示词大改、模型换代)。

双跑对比要比什么

· 逐条输出来源:同一输入,两版结果的差异类型(更准 / 更差 / 不同但都行);

· 格式合规率(新版是否更容易破格式);

· 长度与成本(新版往往更长更贵);

· 失败类型分布(有没有引入新的坏模式);

· 延迟(新版可能更慢,尤其是换了更大的模型)。

⚠️ 成本提醒:双跑会让成本与并发翻倍 ✗ —— 必须限时(例如 3 天)、限比例(例如 10% 流量)、

并提前把额度与告警准备好 ✔。

上线判据要事先写死

```

✓ 格式合规率 ≥ 旧版

✓ 逐条对比中「更差」占比 ≤ 5%

✓ 失败类型没有新增的严重类别(编造、越权)

✓ P95 延迟 ≤ 旧版 × 1.2

✓ 单位成本 ≤ 预算线

```

任一不达标 → 不上线(而不是"再看看" ✗)。

影子模式的两个陷阱

· 影子里的输入与线上不同 ✗:只挑"看起来难"的请求进影子 → 结论不可迁移 ✔;

正确做法是按比例随机采样真实请求 ✔。

· 影子结果没人看 ✗:每天要有人(或脚本)过一遍差异清单 ✔,否则等于白跑 ✗。

落地顺序

1. 先做离线回放(零成本、零风险,能用历史请求先筛掉明显更差的版本);

2. 通过后再做双跑对比(限时、限比例、有告警);

3. 达标后小流量灰度 → 全量;

4. 全程保留一键回滚开关 ✔(没有回滚就不要全量 ✗)。

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

相关文章

顺序阅读

← 上一篇:对话式产品的空状态:怎么让用户问对问题
下一篇:AI 功能的「可解释」:该解释什么、不该解释什么 →

第 48 / 171 篇

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

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