載入中
載入中

當 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 產出物,帶有編號 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 應用程式更值得信賴、更可驗證。