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

把评测结果做成能看懂的报表:三张图与三条纪律

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

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

只看总量会漏掉「总量不变但编造变多」。

评测报告写给谁看

评测做得很扎实,但决策者看不懂 ✗,结果就是"报告发了没人看、决策靠感觉" ✗。

问题不在数据,而在呈现:一张几十行的指标表 ✗ ≠ 能支持决策的信息 ✔。

给决策者的报告,三张图就够 ✔。

图一:质量趋势(按周)

· 横轴时间、纵轴主指标(例如任务完成率)✔;

· 同时画失败类型占比堆叠(编造 / 格式 / 漏答 / 拒答 ✔);

· 目的:看出"总量在升还是在降"与"结构有没有恶化" ✔。

要点:只看总量会漏掉"总量不变但编造变多" ✗(见反馈闭环那篇 ✔)。

图二:改动前后对照(净胜数 + 区间)

· 每次改动画一条:净胜数与置信区间 ✔;

· 区间跨 0 → 标"未观察到显著差异" ✔(见小样本那篇 ✔);

· 目的:让决策者一眼看出"这次改动到底有没有用" ✔。

要点:不要用"明显更好" ✗;用净胜数与区间 ✔。

图三:成本 × 质量散点

· 横轴单位成本、纵轴质量指标 ✔;

· 每个点=一个功能(或一个模型版本 ✔);

· 画出预算线与质量下限 ✔;

· 目的:直接暴露"贵但不好"与"便宜且够用"的两类对象 ✔。

这张图最能推动决策 ✔:优化方向通常一眼就出来了 ✔。

三个呈现纪律

1. 每张图有结论句 ✔("本周编造占比从 4% 升到 7%,主要来自长文档场景" ✔);

2. 不确定的如实标注 ✔(样本量不足、区间跨 0 ✔);

3. 不放原始明细 ✗(明细放附录/链接 ✔)。

一份报告的最小结构

```

1. 本周结论(3 行以内)

2. 三张图(趋势 / 对照 / 成本-质量)

3. 需要决策的事项(1~3 条,每条给建议与代价)

4. 附录:样本量、口径、未解决风险

```

一条判据

> 决策者只看第一页,能否做出"继续 / 回滚 / 调预算"的决定 ✔?

> 不能,说明报告是给评测者自己看的 ✗,不是给决策者的 ✔。

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

相关文章

顺序阅读

← 上一篇:如何在内部推动 AI 工程规范:从门禁开始
下一篇:AI 功能的灰度开关设计:谁、什么时候、怎么关 →

第 61 / 171 篇

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

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