加载中
加载中

当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的响应会变得更加复杂。您得到的不再是简单的文本,而是带有引用信息的结构化内容:

下面列出的五个引用字段的示例值:一句被引用的文本、索引0、"earth.pdf"、第4和第5页。

每个引用都包含:

  • cited_text - Claude所引用的来自您文档中的确切文本
  • document_index - 所引用的是哪个文档(如果您提供了多个文档的话)
  • document_title - 您为该文档指定的标题
  • start_page_number - 被引用文本的起始位置
  • end_page_number - 被引用文本的结束位置

构建引用界面

引用功能的真正威力来自于构建能够展示这些信息的用户界面。您可以在文本中创建带编号的引用标记,链接到详细的引用信息:

关于地球大气层如何形成的Claude artifact,带有编号1到7的引用标记,并高亮显示了一句被引用的句子。

当用户悬停或点击引用编号时,他们会准确地看到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应用程序更加可信、可验证。