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

AI 功能的「可解释」:该解释什么、不该解释什么

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

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

好的解释让用户能做决定:信、不信、还是去核对。

"可解释"不是把提示词贴给用户

给 AI 功能加解释,最常见的做法是把系统提示词、检索片段、模型思考过程一股脑展示出来 ✗。

结果:用户看不懂、还可能泄露不该给的信息 ✗。

可解释的目标是"让用户能判断该不该信" ✔,不是"让用户看到内部实现" ✗。

该解释的三件事

1. 结论依据:用了哪些资料(标题 + 出处),可点开看原文;

2. 不确定性:哪里没有把握(资料没覆盖、结论依赖推断、数据可能过期);

3. 能做什么:不满意时用户能怎么改(换关键词、限定范围、要求只看官方来源)。

不该解释的三件事

· 系统提示词原文(既无用又是注入面,见红队那篇);

· 模型内部推理(对判断可信度帮助很有限,还可能误导);

· 内部路径与配置(日志、密钥名、服务名 —— 属于信息泄露)。

怎么表达"不确定性"(要具体,不要空话)

| 别写 | 改写 |

|---|---|

| 结果可能不准确 | 该结论来自 2024-03 的文档,之后可能有更新 |

| 仅供参考 | 未在资料中找到关于 X 的说明,以下为通用做法 |

| 置信度 0.72 | 3 条资料支持该说法,1 条与之不一致(已列出) |

要点:不确定性要指向具体来源与缺口 ✔,而不是加一句免责声明 ✗。

引用要能核对(不是装饰)

· 引用编号必须与证据表里的条目一一对应(见证据表那篇 ✔);

· 做子串级校验:引用的原话确实出现在该来源片段里 ✔;

· 引用失效(来源被删/改)时要能标注出来,而不是静默保留 ✗。

什么时候该"不解释"

· 极简交互场景(一句话问答)—— 解释会让界面变重 ✗;

· 解释会暴露隐私或安全细节 ✗;

· 用户已明确表示"只要结果" ✔(提供"展开依据"入口即可 ✔)。

一条判据

> 好的解释应该让用户能做决定:信、不信、还是去核对 ✔。

> 如果读完解释他还是只能"感觉一下",那这份解释只是装饰 ✗。

落地顺序

1. 先做"结论依据 + 可点开原文"(收益最大);

2. 再做具体的"不确定性"表达;

3. 最后做"用户能怎么改"的操作入口。

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

相关文章

顺序阅读

← 上一篇:影子模式:新版先暗跑,再决定要不要切
下一篇:评测里最容易被忽略的一类:拒答与澄清 →

第 49 / 171 篇

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

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