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

AI 功能的用户教育:怎么让用户用对

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

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

没看过任何文档的新用户,第一次提问的有效率是多少?

用户用不对,不是用户的问题

AI 功能上线后最常见的抱怨是"效果不好" ✗,但查下去常常是用法不对 ✔:

问得太宽、没给关键前提、把不适合的任务交给它 ✔。

用户教育不是写一篇帮助文档 ✔,而是把"怎么用对"做进产品 ✔。

一、四个做进产品的教育点

1. 输入提示(占位符给"示例问法" ✔,而不是"请输入内容" ✗);

2. 可点示例(真实高频、答得好的问题 ✔,点击即问 ✔ —— 见空状态那篇 ✔);

3. 同理的即时引导(检测到问题过宽时先追问一句限定 ✔);

4. 能力边界提示(在入口处写"适合做什么、不适合什么" ✔)。

二、把"失败"变成教学时刻

当结果不理想时(用户点踩、反复改写、追问 ✔),提示里可以给:

· 更具体的问法示例 ✔("试试加上时间范围和地区" ✔);

· 换个入口的建议 ✔("这类问题用文档检索更合适" ✔);

· 承认能力边界 ✔("该任务超出当前能力,建议人工处理" ✔)。

要点:失败提示要可行动 ✔(与降级提示同一原则 ✔)。

三、教育材料要"随功能变"

· 功能更新后,示例与说明要同步更新 ✔(否则示例变成"过时用法" ✗);

· 示例要定期从日志里筛 ✔(挑高频且答得好的 ✔),而不是一次性写好就不管 ✗;

· 把"用户最常犯的三个误用"写进文档与提示 ✔(每周看失败类型就能得到 ✔)。

四、该测什么

· 首次提问的有效率(能回答的问题占比 ✔);

· 澄清率(需要追问的比例 ✔ —— 越低越好,但不是越低越对:该追问还是得追问 ✔);

· 误用率(把明显不适合的任务提交上来的比例 ✔);

· 改问率(用户自己改问法的比例 ✔ —— 高说明首次引导不足 ✔)。

五、三个反模式

· 只写帮助文档 ✗(用户不看 ✔);

· 把误用当"用户太笨" ✗(是产品没引导好 ✔);

· 示例万年不变 ✗(能力变了,示例没变 ✔)。

一条判据

> 一个没看过任何文档的新用户 ✔,第一次提问的"有效率"是多少 ✔?

> 低于一半,说明引导没做进产品 ✗。

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

相关文章

顺序阅读

← 上一篇:检索里的否定与例外:别让模型只看到一半
下一篇:把重试做对:什么时候该重试、什么时候该放弃 →

第 87 / 171 篇

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

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