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

把评测口径写下来:指标定义与计算方式

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

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

让两个人独立按文档算同一指标,结果一致吗?

指标说不清口径,就没法比

"正确率 85%" ✔ —— 哪个正确率 ✔?谁来判 ✔?分母是什么 ✔?

口径不清的指标,跨周不可比、跨人不可复现 ✗,等于没有指标 ✔。

把口径写下来 ✔(一张小卡片 ✔),应成为评测脚本的注释与文档的附录 ✔。

一、每个指标要写清五件事

```

① 定义(一句话,可判定 ✔)

② 分子/分母(怎么算 ✔)

③ 数据来源(哪批样本、哪个集合 ✔)

④ 判定方式(规则 / 人工 / 模型打分 ✔ —— 谁判的 ✔)

⑤ 排除项(哪些样本被剔除、为什么 ✔)

```

第 ⑤ 项最常被省 ✗ —— 剔除规则不写清,等于可以"调指标" ✔。

二、常见指标的推荐口径

| 指标 | 推荐口径 |

|---|---|

| 正确率 | 判定为"对"的条数 / 全部有效样本(排除输入无效的 ✔) |

| 格式合规率 | 通过 schema 校验的条数 / 全部调用(含失败 ✔) |

| 该拒答却作答率 | 资料不足样本中给出确定断言的条数 / 资料不足样本总数 ✔ |

| 引用一致率 | 引用与结论相关的条数 / 有引用的条数 ✔ |

| 单位成本 | 总成本 / 成功调用数(不含失败 ✔ 还是含,要写明 ✔) |

注意 ✗:单位成本的分母写"全部调用"还是"成功调用",会让数字差很多 ✔ ——

必须写明 ✔(我见过两个团队因此争论半天 ✔)。

三、口径变更要留痕

· 改口径 = 指标不可与历史直接比 ✔ → 必须标注"口径已变" ✔;

· 最好做法:新增口径而不是修改旧口径 ✔(两套并行一段时间 ✔);

· 变更记录进评测脚本注释与变更说明 ✔。

四、三个反模式

· 一个人一个算法 ✗(同一指标两种结果 ✔);

· 口径写在某人脑子里 ✗(他休假就没人说得清 ✔);

· 为了好看悄悄改口径 ✗(这是最坏的 ✔)。

五、一条判据

> 让两个人独立按文档算同一个指标 ✔,结果一致吗 ✔?

> 不一致,说明口径还没写清 ✗。

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

相关文章

顺序阅读

← 上一篇:AI 输出的可读性:结构、长度与重点
下一篇:把检索日志用起来:从查询分布发现内容缺口 →

第 129 / 171 篇

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

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