引用

當 Claude 根據您提供的文件回答問題時，使用者可能會以為它只是從訓練數據中提取資訊。但如果 Claude 實際上是在引用特定來源呢？引用功能讓您能夠向使用者展示 Claude 究竟從何處找到其資訊，為您的 AI 應用程式建立信任與透明度。

為什麼引用很重要

沒有引用時，使用者會認為 Claude 的回應是來自記憶。他們無法驗證資訊，也無法理解這是基於您提供的特定文件。引用功能透過向使用者展示 Claude 用來生成其回應每個部分的確切來源材料，解決了這個問題。

啟用引用功能

要啟用引用功能，請在您的文件訊息中新增兩個欄位：

{
  "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 - 哪一份文件（如果您提供了多份文件）
• document_title - 您為該文件指定的標題
• start_page_number - 被引用文字開始的位置
• end_page_number - 被引用文字結束的位置

建立引用介面

引用功能的真正威力來自於建立能夠顯示它們的使用者介面。您可以在文字中建立編號參考，連結到詳細的引用資訊：



當使用者將滑鼠懸停在引用編號上或點擊它們時，他們會確切看到 Claude 參考了哪份文件和哪些頁面。這種透明度有助於使用者驗證資訊，並建立對 Claude 回應的信心。

純文字引用

引用功能不僅限於 PDF。您也可以將它們用於純文字文件：

{
  "type": "document", 
  "source": {
    "type": "text",
    "media_type": "text/plain",
    "data": article_text,
  },
  "title": "earth article",
  "citations": { "enabled": True }
}

使用純文字時，您會得到 CitationCharLocation 物件，而不是頁面位置。這些物件提供文字中的字元位置，讓您能夠突顯 Claude 所參考的確切句子或段落。

何時使用引用功能

在以下情況下，引用功能是必不可少的：

• 使用者需要驗證資訊的準確性
• 您正在處理敏感或重要的文件
• 關於來源的透明度能為您的應用程式建立信任
• 使用者可能想要閱讀原始來源材料

透過實作引用功能，您將 Claude 從一個只給出答案的「黑盒子」轉變為一個展示其運作過程的透明系統，使您的 AI 應用程式更值得信賴且可驗證。