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

模型换代怎么迁:对照、灰度与回滚

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

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

只测正确率会漏掉格式与拒答倾向的变化。

换代不是"换个模型名"

模型换代(同门新版本、或换成别家)常被当成一次配置改动 ✗,实际是行为变更 ✔:

输出风格、格式遵守、长度分布、拒绝倾向、成本与延迟都可能变 ✔。

迁移要当成一次正式变更来做 ✔:先对照、再影子、再灰度、能回滚 ✔。

一、迁移前:三项准备

1. 评测集冻结(含拒答/澄清类样本 ✔,见那篇 ✔)+ 基线指标(正确率、格式合规率、成本、延迟);

2. 提示词适配清单:新模型常对提示词风格更敏感(示例数量、格式指令强度)→

准备"原样迁移"与"轻量适配"两套,分别评估 ✔(别默认原样就行 ✗);

3. 回滚方案:保留旧模型调用路径 + 一键切回 ✔(没有回滚就不要迁 ✗)。

二、对照:先离线,再影子

· 离线对照(零风险):历史请求重放,逐条比对差异类型(更准/更差/不同但都行)✔;

· 影子模式:真实流量双跑(限时 3 天、限比例 10% ✔),比格式合规率、失败类型、成本、P95 延迟 ✔。

⚠️ 影子会让成本与并发翻倍 ✗ —— 提前准备额度与告警 ✔。

三、灰度:按"受影响面"而不是按比例

按比例放量(1% → 10% → 50% → 100%)是最常见的做法 ✔,但要注意:

· 若不同租户/场景对模型敏感度差异大,按比例可能掩盖某类请求的严重退化 ✗ →

更稳的是先放低风险场景(内部工具、非关键路径)✔,再放高影响场景 ✔;

· 每一步的判据(格式合规、失败类型、延迟、成本)要达到✔才继续 ✔,否则回滚 ✔。

四、迁移中常见的四个坑

1. 只测正确率 ✗ → 格式与长度变化会让下游解析崩 ✗(必须测格式合规率 ✔);

2. 忽略成本变化 ✗ → 新模型可能更贵(或更啰嗦导致更贵 ✔);

3. 忽略拒绝倾向变化 ✗ → 新模型可能更保守(过度拒答 ✗),用户觉得"变差了" ✔;

4. 提示词没适配就下结论 ✗ → 有时只需调示例数量就能追平 ✔。

五、迁移后:把旧路径留一段时间

· 旧模型路径保留 2~4 周 ✔(出问题能快速切回 ✔);

· 记录迁移前后的单位成本与质量指标 ✔,写进交接文档 ✔;

· 把迁移中发现的坏样本补进评测集 ✔(下次迁移能用 ✔)。

六、上线判据(建议直接抄)

```

✓ 格式合规率 ≥ 旧版

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

✓ 该拒答却作答率没有升高

✓ P95 延迟 ≤ 旧版 × 1.2

✓ 单位成本 ≤ 预算线

✓ 灰度期间无新增严重失败类型

```

任一不达标 → 回滚(而不是"再观察" ✗)。

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

相关文章

顺序阅读

← 上一篇:小样本下的效果判断:什么时候该说「看不出来」
下一篇:推理成本与「思考长度」:该在哪儿设上限 →

第 54 / 171 篇

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

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