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

输入示例库:好的提问长什么样

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

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

示例与实际能力不符,是最伤信任的一类。

用户不会问,只会"随便写一句"

同一个功能,好提问与坏提问的结果差距巨大 ✔:

"帮我写个方案" ✗ vs "为一家 20 人的 SaaS 公司写一份新客户上手方案,面向技术负责人,800 字以内" ✔。

建一个"输入示例库" ✔:把"好的提问长什么样"直接摆给用户看 ✔。

一、示例库要有什么

```

① 每条示例:完整输入(用户可直接点用)

② 一句话说明:为什么这样问效果更好

③ 场景标签:适合谁、什么时候用

④ 反面示例(可选但很有用):这样问会差在哪

```

第 ② 项最关键 ✗→✔:只给示例不解释 ✔,用户会照抄但学不会 ✔;

解释了"为什么" ✔ → 用户能迁移到自己的场景 ✔。

二、示例从哪来(别自己编 ✗)

· 真实日志里的高频好案例 ✔(用户问过且结果好的 ✔ —— 见查询日志那篇 ✔);

· 人工审核里的"标杆修改" ✔(审核员改得最好的那几条 ✔ —— 见审核队列 ✔);

· 客服记录里的成功解决 ✔。

要点:示例必须真实出现过 ✔(编的示例往往"太完美",不具代表性 ✗)。

三、怎么呈现(三个位置)

1. 空状态(第一次进来就看到 ✔ —— 见空状态那篇 ✔);

2. 输入框上方(可横向滚动的示例卡片 ✔);

3. 失败提示里("试试这样问:…" ✔ —— 见用户教育那篇 ✔)。

要点:示例要可点击直接使用 ✔,而不是只能看 ✔。

四、示例库要维护

· 每月更新(能力变了,示例要变 ✔);

· 淘汰不再有效的(模型换代后老示例可能不再好用 ✔);

· 标注"最近更新"(用户会信任更新的示例 ✔);

· 统计点击率(哪些示例被用得最多 ✔ → 说明这类需求高频 ✔)。

五、三个反模式

· 示例写得像广告 ✗("输入任何内容都能得到完美答案" ✔);

· 只给一个示例 ✗(用户以为只能这么问 ✔);

· 示例与实际能力不符 ✗(点了发现做不了 ✔ —— 最伤信任 ✔)。

六、一条判据

> 新用户第一次进来 ✔,能否点一个示例就得到满意结果 ✔?

> 不能,说明示例库要么没有、要么不真实 ✗。

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

相关文章

顺序阅读

← 上一篇:改 A 坏了 B:横向回归怎么发现
下一篇:数据质量前置检查:脏数据不要进模型 →

第 159 / 171 篇

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

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