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

把提示词改动接进流水线:四道关与各自判据

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

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

只凭几条样本就上线,是最常见的反模式。

提示词改动最容易"悄悄上线"

多数团队的提示词改动流程是:本地试几条 → 改了线上配置 → 看用户反馈 ✗。

中间没有对照、没有回归、没有留痕 ✔ —— 出问题时也说不清"到底哪次改动导致的" ✗。

给提示词改动设四道关,就能把这件事变可控 ✔。

第一关:本地试跑(发现问题,不当作结论)

· 用 5~10 条边界样本快速试(空输入、超长、含噪声 ✔);

· 目的是"排除明显错误"✔,不是判断效果 ✔(见小样本那篇 ✔);

· 边界样本进版本库 ✔(下次还能用 ✔)。

第二关:离线对照(真正的效果判断)

· 同一批评测样本(100~300 条 ✔),只改被测的那一处 ✔;

· 逐条成对比较,输出净胜数 + 区间 ✔;

· 看失败类型变化(新增了哪类错 ✔);

· 判据事先写死(例如"净胜 ≥ 0 且无新增严重失败" ✔)。

这一关是唯一能说"效果变好"的关 ✔ —— 其它关都不算证据 ✔。

第三关:影子/灰度(真实流量验证)

· 影子双跑(限时、限比例 ✔)比格式合规率、长度、成本、延迟 ✔;

· 再小流量灰度 ✔,盯四组指标(见灰度那篇 ✔);

· 两版并存:旧版随时能切回 ✔。

第四关:上线与留痕

· 提示词版本号进请求日志 ✔(见可复现那篇 ✔);

· 变更说明写清:动机、做法、证据、回滚方式 ✔;

· 更新评测集(把这次发现的坏样本补进去 ✔)。

四关各自的"通过判据"(建议直接抄)

```

第一关:无崩溃/格式错;边界样本通过

第二关:净胜数 ≥ 0 且区间不跨负;无新增严重失败类型

第三关:格式合规率不降;单位成本 ≤ 预算 × 1.2;P95 ≤ 旧版 × 1.2

第四关:版本号进日志;变更说明齐备;评测集已更新

```

两个常见反模式

· 跳过第二关 ✗(只凭几条样本就上线 ✔)—— 这是最常见的 ✗;

· 一次改多处 ✗(无法归因,出问题不知道回滚哪一处 ✔)。

一条判据

> 出问题时,能否在 5 分钟内回答"这是哪次提示词改动导致的" ✔?

> 不能,说明四道关没有真正跑起来 ✗。

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

相关文章

顺序阅读

← 上一篇:工具返回值要按「给人看」设计:结构化、摘要与溯源
下一篇:AI 功能的权限模型:能做与不能做要显式声明 →

第 73 / 171 篇

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

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