交互与用户体验 / 系统课时
给答案添加可定位的引用
给答案添加可定位的引用
当 AI 的回答同时包含操作步骤、权限条件和判断结论时,单把资料链接堆在末尾,读者很难知道每一句依据何在。本课以一则虚构的订单导出问答为例,设计从行内编号直达原文段落的引用方式,并验证引用是否真正支持对应断言。
学习目标
- 将回答拆成可核对的断言,为每项结论匹配具体证据。
- 设计行内引用、来源列表和原文定位之间的交互。
- 识别“检索命中但证据不足”的情况,完成引用验收。
把答案拆成可核对的断言
先给每条可查证的信息找证据,再决定是否显示引用。以演示用的虚构知识库为例:《订单操作说明》的“导出步骤”写明“选择订单、点击导出、选择 CSV”;《导出权限规则》的“权限范围”写明“具有订单导出权限的账号才能操作”。
这两份资料分别支持操作步骤与权限条件,却都没有提到“导出一定在 10 秒内完成”。因此,后者不能靠附上任意一个来源编号变成事实。
| 回答中的断言 | 证据位置 | 处理 |
|---|---|---|
| 订单可选择 CSV 格式导出 | 《订单操作说明》·导出步骤 | 可引用 |
| 账号需要订单导出权限 | 《导出权限规则》·权限范围 | 可引用 |
| 导出保证在 10 秒内完成 | 两份资料均未提及耗时 | 删除数字或继续核实 |
产品设计时,建议给每条断言记录“对应来源、具体段落、支持程度”三项信息;只有找到直接或足够明确的支持内容,才让引用标记进入最终回答。
让编号紧跟被支持的句子
下方是一段可以直接放进原型的回答文案,编号表示界面里的可点击引用,不是 Markdown 脚注:
在订单列表选中记录,点击“导出”[1]。文件格式选择 CSV[1]。账号需具有订单导出权限[2]。
编号按可定位证据首次出现的顺序分配。同一文档版本的同一片段可以复用一个编号。同一文档中的不同片段如果需要分别定位,应使用不同编号,或在来源条目下保留多个明确位置。若一个断言依赖两处证据,可同时显示对应编号。
标记紧贴对应断言、放在句末标点前,不要在包含多个不同事实的整段末尾只挂一个编号。重新回答时展示编号可以重新排序,但内部必须保留来源的稳定标识及定位信息,不能把“1”当作永久来源 ID。
点击标记打开面板时使用原生按钮,直接导航到来源时使用链接。为编号提供可访问名称,例如“查看来源 1,订单操作说明”。只有用户确实有权看见来源标题时才在按钮名称中带出标题。移动端可通过内边距或间隔增大实际操作区域,并检查行内引用对应的触控规则和相邻目标。
从来源编号定位到原文段落
参考资料列表按 [1]、[2] 排列。每条至少显示文档标题、原文位置、可打开的来源入口;只有资料确实提供发布时间或版本号时才展示,不能把检索时间冒充文档更新时间。
| 编号 | 参考资料列表显示 | 点击后的定位目标 |
|---|---|---|
| [1] | 《订单操作说明》·导出步骤 | 高亮包含“选择订单、点击导出、选择 CSV”的段落 |
| [2] | 《导出权限规则》·权限范围 | 高亮包含“具有订单导出权限”的段落 |
桌面端点击 [1],可在回答右侧打开来源面板,滚动到目标段落并高亮相关文字;手机端可改用底部抽屉,关闭后保留答案原来的滚动位置。可用的定位依据包括章节锚点、段落标识、PDF 页码或视频时间戳,具体取决于实际来源。

如果来源已改版、段落锚点失效,应明确提示“精确定位不可用,可打开原文”,而不是悄悄跳转文档首页、仍假装已完成精确定位。
区分检索命中与事实证明
检索结果只是候选证据;相似度高并不代表断言真实。例如资料只写“具有订单导出权限的账号可操作”,就不能推导成“只有管理员能导出”,因为有权限的角色未必只有管理员。
审核时逐项检查原文是否明确支持主体、动作、条件、数值和时效。对“只能”“一定”“实时”“10 秒内”等强断言尤其严格;若来源仅支持部分内容,就缩小回答范围或标注不确定性,不要用一个看似权威的编号遮盖缺口。
按证据位置生成编号
下面用已审核的支持关系生成 UI 编号。证据服务先按当前授权返回稳定记录。编号函数只使用可见记录及已审核的断言与证据映射。检索排名和模型自行建议的编号无需进入这份映射。保存为 citations.mjs,使用 Node.js 运行。
function citationLayout(claims, evidence, support) {
const byLocation = new Map();
const references = [];
const items = claims.map(claim => {
const labels = new Set();
for (const id of support.get(claim.id) ?? []) {
const row = evidence.get(id);
if (!row) continue;
const key = JSON.stringify([row.docId, row.version, row.anchor]);
if (!byLocation.has(key)) {
const number = references.length + 1;
references.push({ number, title: row.title, docId: row.docId, version: row.version, anchor: row.anchor });
byLocation.set(key, number);
}
labels.add(byLocation.get(key));
}
return { id: claim.id, labels: [...labels], supported: labels.size > 0 };
});
return { items, references };
}
const evidence = new Map([
["steps", { docId: "export", version: "v2", anchor: "steps", title: "订单操作说明" }],
["role", { docId: "export", version: "v2", anchor: "permissions", title: "订单操作说明" }],
]);
const layout = citationLayout(
[{ id: "csv" }, { id: "click" }, { id: "role" }, { id: "speed" }],
evidence,
new Map([["csv", ["steps"]], ["click", ["steps"]], ["role", ["role"]]]),
);
console.log(layout.items.map(item => item.labels.join(",") || "待核实").join(" / "));
console.log(layout.references.map(row => row.anchor).join(" / "));预期输出
1 / 1 / 2 / 待核实
steps / permissions示例默认每条支持记录都能独立证明对应断言。如果需要几条资料共同证明,先由审核逻辑验证整组证据齐全,再输出引用。缺少任一必需证据时缩小断言范围或标记未核实。
用具体操作验收引用交互
- 使用上述三句话测试:界面应出现三个标记 [1]、[1]、[2],但参考资料列表只有两条;两处 [1] 都打开同一份文档的正确段落。
- 故意让 [2] 的段落定位失效:界面需提示定位失败,同时保留打开来源文档的入口,不能空白或错误高亮。
- 在约 360 CSS px 的窄屏检查底部抽屉:能关闭并返回原阅读位置,引用标记不与相邻文字重叠。
- 用键盘聚焦引用并按 Enter 打开、Esc 关闭;读屏名称至少能表达“来源 1:订单操作说明”,不能只朗读数字“1”。
- 把“10 秒内完成”重新加入答案:在没有新证据时,该句应被删除或标为未经核实,不能自动挂上 [1] 或 [2]。
交付前逐条核对“断言—编号—来源条目—原文位置”四个节点。任何一个节点无法对应,都应修复引用或调整句子,而不是让用户自行猜测证据支持到哪里。