Zitate

Claude kann detaillierte Zitate bereitstellen, wenn Fragen zu Dokumenten beantwortet werden, um Ihnen dabei zu helfen, Informationsquellen in Antworten zu verfolgen und zu überprüfen.

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

Hier ist ein Beispiel für die Verwendung von Zitaten mit der Messages API:

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-7",
    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 Zitate funktionieren

Integrieren Sie Zitate 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 werden, aber nicht für zitierte Inhalte verwendet werden.
• title ist in der Länge begrenzt, daher kann das context-Feld nützlich sein, um Dokumentmetadaten als Text oder stringifiziertes JSON zu speichern.

Zitat-Indizes

• Dokumentindizes sind 0-indiziert aus der Liste aller Dokumentinhaltsblöcke in der Anfrage (über alle Nachrichten hinweg).
• Zeichenindizes sind 0-indiziert mit exklusiven Endindizes.
• Seitenzahlen sind 1-indiziert mit exklusiven Endseitenzahlen.
• Inhaltsblockindizes sind 0-indiziert mit exklusiven Endindizes aus der content-Liste, die im benutzerdefinierten Inhalts-Dokument bereitgestellt wird.

Token-Kosten

• Das Aktivieren von Zitaten führt zu einem leichten Anstieg der Eingabe-Token aufgrund von Systemaufforderungen und Dokumentaufteilung.
• Die Zitate-Funktion ist jedoch sehr effizient mit Ausgabe-Token. Im Hintergrund gibt das Modell Zitate in einem standardisierten Format aus, die dann in zitiertem Text und Dokumentort-Indizes geparst werden. Das cited_text-Feld wird zur Vereinfachung bereitgestellt und zählt nicht zu Ihren Ausgabe-Token.
• Wenn cited_text in nachfolgenden Gesprächsrunden zurückgegeben wird, wird es auch nicht zu den Eingabe-Token gezählt.

Funktionskompatibilität

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

Verwendung von Prompt-Caching mit Zitaten

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

Die in Antworten generierten Zitierblöcke können nicht direkt zwischengespeichert werden, aber die Quelldokumente, auf die sie verweisen, können zwischengespeichert werden. Um die Leistung zu optimieren, wenden Sie cache_control auf Ihre Dokumentinhaltsblöcke auf oberster Ebene an.

In diesem Beispiel:

• Der Dokumentinhalt wird mit cache_control im Dokumentblock zwischengespeichert
• Zitate sind im Dokument aktiviert
• Claude kann Antworten mit Zitaten generieren und dabei von zwischengespeicherten Dokumentinhalten profitieren
• Nachfolgende Anfragen mit demselben Dokument profitieren vom zwischengespeicherten Inhalt

Dokumenttypen

Auswahl eines Dokumenttyps

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

Klartext-Dokumente

Klartext-Dokumente werden automatisch in Sätze aufgeteilt. Sie können sie inline oder durch Referenz mit ihrer file_id bereitstellen:

PDF-Dokumente

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

Benutzerdefinierte Inhalts-Dokumente

Benutzerdefinierte Inhalts-Dokumente geben Ihnen Kontrolle über die Zitierungsgranularität. Es wird keine zusätzliche Aufteilung durchgeführt und Chunks werden dem Modell gemäß den bereitgestellten Inhaltsblöcken bereitgestellt.

{
    "type": "document",
    "source": {
        "type": "content",
        "content": [
            {"type": "text", "text": "First chunk"},
            {"type": "text", "text": "Second chunk"},
        ],
    },
    "title": "Document Title",  # optional
    "context": "Context about the document that will not be cited from",  # optional
    "citations": {"enabled": True},
}

Antwortstruktur

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

{
    "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

Für Streaming-Antworten ist ein citations_delta-Typ enthalten, der ein einzelnes Zitat enthält, das zur citations-Liste im aktuellen text-Inhaltsblock hinzugefügt werden soll.