4.Citations
此文档由 学习AI的1000天 翻译制作(抖音，B站，YouTube)
邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org
==================================================
当Claude基于您提供的文档回答问题时，用户可能会认为它只是在利用其训练数据。但如果Claude能够准确显示它在哪里找到了特定信息会怎么样？这就是引用功能的作用所在——这是一个强大的功能，让Claude能够引用您源文档的特定部分，并向用户准确显示每条信息的来源。
引用的重要性
想象一下向Claude询问地球大气层是如何形成的，并得到详细答案。如果没有引用，用户无法验证信息或理解Claude实际上是在引用您提供的特定文档。引用通过创建从Claude的回答到您源材料的清晰路径来解决这个透明度问题。
Enabling Citations
要启用引用功能，您需要修改文档消息结构。在您的文档块中添加两个新字段：
{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": file_bytes,
},
"title": "earth.pdf",
"citations": { "enabled": True }
}
title字段为你的文档提供一个可读的名称，而citations: {"enabled": True}告诉Claude跟踪它找到信息的位置。
理解引用结构
当启用引用功能时，Claude的响应变得更加复杂。你获得的不再是简单的文本，而是包含每个声明引用信息的结构化数据。
每个引用包含几个关键信息：
- cited_text - 支持Claude陈述的文档中的确切文本
- document_index - Claude引用的是哪个文档（当你提供多个文档时很有用）
- document_title - 你为文档分配的标题
- start_page_number - 被引用文本的起始页码
- end_page_number - 被引用文本的结束页码
构建带引用的用户界面
引用功能的真正威力在于构建用户界面，使这些信息变得易于访问。您可以创建交互式元素，让用户将鼠标悬停在引用标记上，准确查看信息的来源。
这创造了一种透明的体验，用户可以：
- 看到Claude的回答基于实际的源材料
- 通过检查原始文档来验证信息
- 理解每个被引用信息片段的上下文
纯文本引用
引用功能不仅限于PDF文档。您也可以将其用于纯文本源。在处理文本时，请像这样修改您的文档结构：
{
"type": "document",
"source": {
"type": "text",
"media_type": "text/plain",
"data": article_text,
},
"title": "earth_article",
"citations": { "enabled": True }
}
对于纯文本来源，Claude不会提供页码，而是会给出字符位置，精确定位到Claude在文本中找到每条信息的确切位置。
何时使用Citations功能
Citations功能在以下情况下特别有价值：
- 用户需要验证信息的准确性时
- 您正在处理用户应该能够参考的权威文档时
- 信息来源的透明度对您的应用程序至关重要
- 用户可能希望探索特定事实周围的更广泛背景
通过实现引用功能，您将Claude从一个提供答案的"黑盒子"转变为一个展示其工作过程的透明研究助手。这能建立用户信任，并使他们能够在需要时深入了解您的源材料。
==================================================
此文档由 学习AI的1000天 翻译制作(抖音，B站，YouTube)
邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org