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

输入预览:提交前让用户确认组装结果

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

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

用户提交前能否看到「系统会带着哪些资料、按什么参数去问」并当场改?

提交前让用户"看一眼组装结果"

AI 功能里,用户输入往往要经过组装 ✔:拼接提示词、插入资料、补默认值 ✔。

这个过程对用户是黑盒 ✗ —— 于是出现"我明明说了 X,它怎么没按 X 答" ✔。

做法:给一个"输入预览" ✔ —— 提交前让用户看到"系统实际会带着什么去问" ✔。

一、该预览什么(三层,按需展开)

```

① 关键要素(表格化):任务类型、长度、受众、时间范围、资料范围

② 采用的资料(片段列表 + 来源 + 时间,见范围控制那篇)

③ 完整组装内容(折叠,高级用户与排查用,见可复现那篇)

```

第 ① 层默认展开 ✔(让用户一眼确认"我表达的意图有没有被正确解析" ✔);

② 层给"已选 5 份资料 [展开]" ✔;③ 层默认折叠 ✔(避免吓到普通用户 ✔)。

二、预览的价值(四件事)

1. 意图核对(用户能发现"系统理解错了" ✔ —— 比看到错误答案后再猜便宜得多 ✔);

2. 减少无效调用 ✔(错在输入层就改 ✔ —— 省钱 ✔);

3. 信任(看着它"带着我给的资料去问" ✔);

4. 可追溯(同一条请求,事后能对回当时的组装 ✔)。

三、三个设计细节

· 可编辑(预览里能直接改参数/去掉某份资料 ✔ —— 而不是退回重填 ✔);

· 默认收敛(默认只显示关键要素 ✔,不要一上来就甩一大段提示词 ✗);

· 不阻塞(想直接提交也能提交 ✔ —— 预览是可选的 ✔)。

四、三个反模式

· 把预览做成技术细节展示 ✗(用户看不懂 ✔);

· 强制逐步确认 ✗(每次都要点"下一步" ✔ —— 与"默认安全但不啰嗦"冲突 ✔);

· 预览与实际不一致 ✗(最坏的一种 ✔ —— 用户按预览判断,实际却不同 ✔)。

五、一条判据

> 用户提交前 ✔,能否看到"系统会带着哪些资料、按什么参数去问" ✔ 并当场改 ✔?

> 不能,说明组装过程还是黑盒 ✗。

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

相关文章

顺序阅读

← 上一篇:AI 功能的运维手册:凌晨三点该看什么
下一篇:代码库问答的四个难点与四项对策 →

第 169 / 171 篇

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

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