加载中
当Claude根据您提供的文档回答问题时,用户可能会以为它只是在从训练数据中提取信息。但如果Claude实际上是在引用特定来源呢?引用功能让您能够向用户准确展示Claude从何处找到其信息,从而为您的AI应用程序建立信任和透明度。
为什么引用很重要
如果没有引用,用户会觉得Claude的回答都来自记忆。他们无法验证这些信息,也无法理解这是基于您提供的特定文档。引用功能通过向用户展示Claude生成每部分回答时所使用的确切源材料来解决这个问题。
启用引用功能
要启用引用功能,请在您的文档消息中添加两个字段:
python
{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": file_bytes,
},
"title": "earth.pdf",
"citations": { "enabled": True }
}title字段为您的文档指定一个出现在引用中的名称。设置enabled: True的citations字段告诉Claude要追踪它在何处找到了信息。
引用结构
当启用引用功能后,Claude的响应会变得更加复杂。您得到的不再是简单的文本,而是带有引用信息的结构化内容:

每个引用都包含:
- cited_text - Claude所引用的来自您文档中的确切文本
- document_index - 所引用的是哪个文档(如果您提供了多个文档的话)
- document_title - 您为该文档指定的标题
- start_page_number - 被引用文本的起始位置
- end_page_number - 被引用文本的结束位置
构建引用界面
引用功能的真正威力来自于构建能够展示这些信息的用户界面。您可以在文本中创建带编号的引用标记,链接到详细的引用信息:

当用户悬停或点击引用编号时,他们会准确地看到Claude引用的是哪份文档以及哪些页面。这种透明度帮助用户验证信息,并增强对Claude回答的信心。
纯文本中的引用功能
引用功能并不局限于PDF文件。您也可以将其用于纯文本文档:
python
{
"type": "document",
"source": {
"type": "text",
"media_type": "text/plain",
"data": article_text,
},
"title": "earth article",
"citations": { "enabled": True }
}对于纯文本,您得到的是CitationCharLocation对象,而不是页面位置信息。这些对象提供文本中的字符位置,使您能够高亮显示Claude所引用的确切句子或段落。
何时使用引用功能
在以下情况下,引用功能至关重要:
- 用户需要验证信息的准确性
- 您正在处理敏感或重要的文档
- 来源的透明度能够为您的应用程序建立信任
- 用户可能想要阅读原始源材料
通过实现引用功能,您将Claude从一个只给出答案的"黑箱"转变为一个展示其工作过程的透明系统,从而使您的AI应用程序更加可信、可验证。