Zitationen

Claude kann detaillierte Zitationen liefern, wenn es Fragen zu Dokumenten beantwortet, und dir so helfen, die Quellen hinter jeder Antwort nachzuverfolgen und zu überprüfen.

Alle aktiven Modelle unterstützen Zitationen, mit Ausnahme von Claude Haiku 3.

Das folgende Beispiel zeigt, wie du Zitationen für ein Klartextdokument mit der Messages API aktivierst:

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "text",
                        "media_type": "text/plain",
                        "data": "The grass is green. The sky is blue.",
                    },
                    "title": "My Document",
                    "context": "This is a trustworthy document.",
                    "citations": {"enabled": True},
                },
                {"type": "text", "text": "What color is the grass and sky?"},
            ],
        }
    ],
)
print(response)



Wie Zitationen funktionieren

Integriere Zitationen mit Claude in diesen Schritten:



Zitierbare vs. nicht zitierbare Inhalte

• Text, der sich im source-Inhalt eines Dokuments befindet, kann zitiert werden.
• title und context sind optionale Felder, die an das Modell übergeben, aber nicht für zitierte Inhalte verwendet werden.
• title ist in der Länge begrenzt, daher ist das Feld context nützlich, um Dokument-Metadaten als Text oder als JSON-String zu speichern.



Zitationsindizes

• Dokumentindizes sind 0-indiziert basierend auf der Liste aller Dokument-Content-Blöcke in der Anfrage (über alle Nachrichten hinweg).
• Zeichenindizes sind 0-indiziert mit exklusiven Endindizes.
• Seitenzahlen sind 1-indiziert mit exklusiven End-Seitenzahlen.
• Content-Block-Indizes sind 0-indiziert mit exklusiven Endindizes aus der content-Liste, die im Dokument mit benutzerdefinierten Inhalten bereitgestellt wurde.



Token-Kosten

• Das Aktivieren von Zitationen führt zu einem leichten Anstieg der Input-Token aufgrund von Ergänzungen am System-Prompt und dem Chunking der Dokumente.
• Die Zitationsfunktion ist jedoch sehr effizient bei den Output-Token. Im Hintergrund gibt das Modell Zitationen in einem standardisierten Format aus, die dann in zitierten Text und Dokumentpositionsindizes geparst werden. Das Feld cited_text wird der Einfachheit halber bereitgestellt und zählt nicht zu den Output-Token.
• Wenn cited_text in nachfolgenden Gesprächsrunden zurückgegeben wird, zählt es ebenfalls nicht zu den Input-Token.



Funktionskompatibilität

Zitationen funktionieren in Verbindung mit anderen API-Funktionen, einschließlich Prompt-Caching, Token-Zählung und Batch-Verarbeitung.



Prompt-Caching mit Zitationen verwenden

Zitationen und Prompt-Caching können effektiv zusammen verwendet werden.

Die in Antworten generierten Zitationsblöcke können nicht direkt gecacht werden, aber die Quelldokumente, auf die sie verweisen, können gecacht werden. Um die Leistung zu optimieren, wende cache_control auf deine Dokument-Content-Blöcke auf oberster Ebene an.

client = anthropic.Anthropic()

# Langer Dokumentinhalt (zum Beispiel technische Dokumentation)
long_document = (
    "This is a very long document with thousands of words..." + " ... " * 1000
)  # Minimum cacheable length

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "text",
                        "media_type": "text/plain",
                        "data": long_document,
                    },
                    "citations": {"enabled": True},
                    "cache_control": {
                        "type": "ephemeral"
                    },  # Cache the document content
                },
                {
                    "type": "text",
                    "text": "What does this document say about API features?",
                },
            ],
        }
    ],
)
print(response)

In diesem Beispiel:

• Der Dokumentinhalt wird mit cache_control auf dem Dokumentblock gecacht.
• Zitationen sind für das Dokument aktiviert.
• Claude kann Antworten mit Zitationen generieren und gleichzeitig vom gecachten Dokumentinhalt profitieren.
• Nachfolgende Anfragen, die dasselbe Dokument verwenden, profitieren vom gecachten Inhalt.



Dokumenttypen



Einen Dokumenttyp wählen

Drei Dokumenttypen werden für Zitationen unterstützt. Dokumente können direkt in der Nachricht bereitgestellt werden (Base64, Text oder URL) oder über die Files API hochgeladen und per file_id referenziert werden:



Klartextdokumente

Klartextdokumente werden automatisch in Sätze aufgeteilt. Du kannst sie inline oder per Referenz mit ihrer file_id bereitstellen:

{
  "type": "document",
  "source": {
    "type": "text",
    "media_type": "text/plain",
    "data": "Plain text content..."
  },
  "title": "Document Title",
  "context": "Context about the document that will not be cited from",
  "citations": { "enabled": true }
}



PDF-Dokumente

PDF-Dokumente können als Base64-codierte Daten, als URL oder per file_id bereitgestellt werden. PDF-Text wird extrahiert und in Sätze aufgeteilt. Da Bildzitationen noch nicht unterstützt werden, können PDFs, die Scans von Dokumenten sind und keinen extrahierbaren Text enthalten, nicht zitiert werden.

client = anthropic.Anthropic()

pdf_base64 = base64.standard_b64encode(
    pathlib.Path("/path/to/document.pdf").read_bytes()
).decode()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "base64",
                        "media_type": "application/pdf",
                        "data": pdf_base64,
                    },
                    "title": "Document Title",
                    "context": "Context about the document that will not be cited from",
                    "citations": {"enabled": True},
                },
                {"type": "text", "text": "Summarize this document."},
            ],
        }
    ],
)
print(response)



Dokumente mit benutzerdefinierten Inhalten

Dokumente mit benutzerdefinierten Inhalten geben dir Kontrolle über die Granularität der Zitationen. Es erfolgt kein zusätzliches Chunking und die Chunks werden dem Modell entsprechend den bereitgestellten Content-Blöcken übergeben.

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "content",
                        "content": [
                            {"type": "text", "text": "First chunk"},
                            {"type": "text", "text": "Second chunk"},
                        ],
                    },
                    "title": "Document Title",
                    "context": "Context about the document that will not be cited from",
                    "citations": {"enabled": True},
                },
                {"type": "text", "text": "Summarize this document."},
            ],
        }
    ],
)
print(response)



Antwortstruktur

Wenn Zitationen aktiviert sind, enthalten Antworten mehrere Textblöcke mit Zitationen:

{
    "content": [
        {"type": "text", "text": "According to the document, "},
        {
            "type": "text",
            "text": "the grass is green",
            "citations": [
                {
                    "type": "char_location",
                    "cited_text": "The grass is green.",
                    "document_index": 0,
                    "document_title": "Example Document",
                    "start_char_index": 0,
                    "end_char_index": 20,
                }
            ],
        },
        {"type": "text", "text": " and "},
        {
            "type": "text",
            "text": "the sky is blue",
            "citations": [
                {
                    "type": "char_location",
                    "cited_text": "The sky is blue.",
                    "document_index": 0,
                    "document_title": "Example Document",
                    "start_char_index": 20,
                    "end_char_index": 36,
                }
            ],
        },
        {
            "type": "text",
            "text": ". Information from page 5 states that ",
        },
        {
            "type": "text",
            "text": "water is essential",
            "citations": [
                {
                    "type": "page_location",
                    "cited_text": "Water is essential for life.",
                    "document_index": 1,
                    "document_title": "PDF Document",
                    "start_page_number": 5,
                    "end_page_number": 6,
                }
            ],
        },
        {
            "type": "text",
            "text": ". The custom document mentions ",
        },
        {
            "type": "text",
            "text": "important findings",
            "citations": [
                {
                    "type": "content_block_location",
                    "cited_text": "These are important findings.",
                    "document_index": 2,
                    "document_title": "Custom Content Document",
                    "start_block_index": 0,
                    "end_block_index": 1,
                }
            ],
        },
    ]
}



Streaming-Unterstützung

Bei Streaming-Antworten kommen Zitationen als Delta-Typ citations_delta innerhalb von content_block_delta-Events an. Jedes Delta enthält eine einzelne Zitation, die der citations-Liste des aktuellen text-Content-Blocks hinzugefügt wird.



Nächste Schritte