交互与用户体验 / 系统课时

给答案添加可定位的引用

给答案添加可定位的引用

当 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 运行。

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(" / "));

预期输出

text
1 / 1 / 2 / 待核实
steps / permissions

示例默认每条支持记录都能独立证明对应断言。如果需要几条资料共同证明,先由审核逻辑验证整组证据齐全,再输出引用。缺少任一必需证据时缩小断言范围或标记未核实。

用具体操作验收引用交互

  1. 使用上述三句话测试:界面应出现三个标记 [1]、[1]、[2],但参考资料列表只有两条;两处 [1] 都打开同一份文档的正确段落。
  2. 故意让 [2] 的段落定位失效:界面需提示定位失败,同时保留打开来源文档的入口,不能空白或错误高亮。
  3. 在约 360 CSS px 的窄屏检查底部抽屉:能关闭并返回原阅读位置,引用标记不与相邻文字重叠。
  4. 用键盘聚焦引用并按 Enter 打开、Esc 关闭;读屏名称至少能表达“来源 1:订单操作说明”,不能只朗读数字“1”。
  5. 把“10 秒内完成”重新加入答案:在没有新证据时,该句应被删除或标为未经核实,不能自动挂上 [1] 或 [2]。

交付前逐条核对“断言—编号—来源条目—原文位置”四个节点。任何一个节点无法对应,都应修复引用或调整句子,而不是让用户自行猜测证据支持到哪里。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

给答案添加可定位的引用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通