読み込み中
読み込み中

Claudeが提供したドキュメントに基づいて質問に答えるとき、ユーザーはそれが単に訓練データから情報を引き出しているだけだと思い込むかもしれません。しかし、もしClaudeが実際に特定の情報源を引用しているとしたらどうでしょうか。引用機能を使うと、Claudeがどこから情報を見つけたのかをユーザーに正確に示すことができ、AIアプリケーションに信頼性と透明性をもたらします。

引用が重要な理由

引用がなければ、ユーザーはClaudeの応答を記憶から生成されたものとして見てしまいます。ユーザーには情報を検証したり、それが提供した特定のドキュメントに基づいていることを理解したりする方法がありません。引用はこの問題を解決し、Claudeが応答の各部分を生成する際に使用した正確な出典元をユーザーに示します。

引用を有効にする

引用を有効にするには、ドキュメントメッセージに2つのフィールドを追加します。

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の応答はより複雑になります。単純なテキストの代わりに、引用情報を含む構造化されたコンテンツを取得します。

以下に記載する5つの引用フィールドの値の例:引用されたテキストの一文、インデックス0、「earth.pdf」、4ページと5ページ。

各引用には以下が含まれます。

  • cited_text - Claudeがドキュメントから参照している正確なテキスト
  • document_index - どのドキュメントか(複数提供した場合)
  • document_title - ドキュメントに割り当てたタイトル
  • start_page_number - 引用されたテキストが始まる位置
  • end_page_number - 引用されたテキストが終わる位置

引用インターフェースの構築

引用の真の力は、それらを表示するユーザーインターフェースを構築することから生まれます。テキスト内に番号付き参照を作成し、詳細な引用情報にリンクさせることができます。

地球の大気がどのように形成されたかに関するClaudeアーティファクト。1から7までの番号付き参照があり、1つの引用文がハイライトされている。

ユーザーが引用番号にホバーしたりクリックしたりすると、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アプリケーションの信頼性と検証可能性を高めます。