Citations

学习笔记：Claude 的引用（Citations）功能

• 核心问题 (Core Problem):
• 用户在使用 AI（如 Claude）获取信息时，可能不清楚 AI 的回答是基于自身记忆还是引用了外部资料。
• 缺乏来源会导致用户对 AI 回答的信任度降低。

• 引用功能 (Citations Feature):
• 定义： 允许 Claude 直接引用外部信息源（如 PDF 或纯文本），并向用户展示信息来源。
• 目的： 帮助开发者构建用户界面（UI），确保用户可以验证 AI 回答的准确性，增强用户信任。

• 使用机制 (Usage Mechanism):
• 在请求（Prompt）中添加 citations 字段，并设置 enabled: true。
• 该功能不仅适用于 PDF 文档，也适用于纯文本（Plain Text）。

• PDF 文档引用结构 (PDF Citation Structure):
• 当引用 PDF 时，返回的结构包含 citation_page_location。
• 关键字段：
• cited_text：源文档中支持 AI 声明的原始文本。
• document_index / document_title：指明信息来源的文档名称和索引。
• start_page / end_page：指明信息在文档中的具体起始页和结束页。

• 纯文本引用结构 (Plain Text Citation Structure):
• 当引用纯文本时，返回的结构包含 citation_char_location。
• 区别： 相比 PDF 的页码定位，纯文本引用提供的是文本块内部的字符位置定位。

• 总结 (Summary):
• 无论使用 PDF 还是纯文本，引用功能都允许开发者在 UI 中创建可点击的提示（如弹窗），让用户快速查阅 AI 回答所依据的原始资料。
• 建议： 当信息来源至关重要时，应始终使用引用功能。

Takeaways

• 引用功能旨在通过展示外部信息源，解决AI回答来源不透明的问题，从而增强用户信任。
• 启用该功能需在请求（Prompt）中添加 citations 字段并设置 enabled: true。
• PDF引用结构提供 page_location（页码定位），而纯文本引用结构提供 char_location（字符位置定位）。
• 开发者可利用引用结构在UI中创建可点击的提示，方便用户快速查阅AI回答所依据的原始资料。