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

服务降级时的用户体验:把「抱歉」写成有用的提示

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

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

静默降级比报错更危险——用户以为在用完整能力。

"抱歉,服务暂时不可用"是最没用的提示

降级或故障时的用户提示,绝大多数产品都写错了 ✗:要么是技术术语 ✗,要么是空洞道歉 ✗,

要么干脆一个转圈 ✗。好的失败提示应该让用户知道"现在能做什么" ✔。

一、提示要回答三个问题

1. 发生了什么(人话,不暴露内部细节 ✔):"当前回答服务繁忙" ✔ / "上游 502" ✗;

2. 你现在能做什么(给 1~2 个可行路径 ✔):"稍后重试""换用关键词搜索""查看原始文档" ✔;

3. 什么时候可能恢复(能给就给 ✔):"预计 5 分钟内恢复" ✔ / "请稍后再试" ✗(太含糊)。

二、按降级层级给不同提示

| 状态 | 提示要点 |

|---|---|

| 正常 | 无需提示 |

| 已降级(小模型/缓存) | 如实标注"当前为快速模式,结果可能较简略" ✔ |

| 部分能力不可用 | 说明哪些能用、哪些不能用 ✔ |

| 完全不可用 | 给出替代入口(离线工具、原文检索、稍后重试)✔ |

最忌讳的是"静默降级" ✗ —— 用户以为在用完整能力,实际拿到兜底结果 ✔(见降级设计那篇 ✔)。

三、让提示"可操作"的三个技巧

· 保留用户输入 ✔:重试时不要让他重新打字 ✗;

· 给一键动作 ✔("重试""换个小模型""只看官方来源");

· 给进度("正在排队,前面 3 个")✔ 比"请等待"有用得多 ✔。

四、错误信息里不要出现的东西

· 内部路径、服务名、版本号、堆栈 ✔(信息泄露 ✗);

· 密钥片段、提示词原文 ✗;

· 无法行动的指责("你的输入不合法" ✗ → 应说"输入过长,请缩减到 2000 字以内" ✔)。

五、怎么验证提示有效

用真实用户视角做五个状态的走查 ✔(正常 / 降级 / 部分不可用 / 不可用 / 限流 ✔),每条问:

1. 我知不知道发生了什么 ✔?

2. 我知不知道下一步做什么 ✔?

3. 我的输入还在不在 ✔?

三问全"是"才算合格 ✔。

一条判据

> 把提示文案单独拿出来读(不看界面 ✔),如果读者不知道"现在该干什么" ✔,

> 那这条提示就是失败的 ✗ —— 无论它多有礼貌 ✗。

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

相关文章

顺序阅读

← 上一篇:把检索质量做成可回归的:黄金集与定期抽样
下一篇:如何在内部推动 AI 工程规范:从门禁开始 →

第 59 / 171 篇

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

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