Zitate

Claude ist in der Lage, detaillierte Zitate zu liefern, wenn es Fragen zu Dokumenten beantwortet, und hilft Ihnen dabei, Informationsquellen in Antworten zu verfolgen und zu verifizieren.

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:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "document",
            "source": {
              "type": "text",
              "media_type": "text/plain",
              "data": "Das Gras ist grün. Der Himmel ist blau."
            },
            "title": "Mein Dokument",
            "context": "Dies ist ein vertrauenswürdiges Dokument.",
            "citations": {"enabled": true}
          },
          {
            "type": "text",
            "text": "Welche Farbe haben das Gras und der Himmel?"
          }
        ]
      }
    ]
  }'

Wie Zitate funktionieren

Integrieren Sie Zitate mit Claude in diesen Schritten:

Zitierbare vs. nicht-zitierbare Inhalte

• Text, der innerhalb des source-Inhalts eines Dokuments gefunden wird, kann zitiert werden.
• title und context sind optionale Felder, die an das Modell weitergegeben werden, aber nicht für zitierten Inhalt verwendet werden.
• title ist in der Länge begrenzt, daher kann das context-Feld nützlich sein, um Dokument-Metadaten als Text oder stringifiziertes JSON zu speichern.

Zitat-Indizes

• Dokumentindizes sind 0-indiziert aus der Liste aller Dokument-Inhaltsblöcke in der Anfrage (über alle Nachrichten hinweg).
• Zeichenindizes sind 0-indiziert mit exklusiven Endindizes.
• Seitenzahlen sind 1-indiziert mit exklusiven End-Seitenzahlen.
• Inhaltsblock-Indizes sind 0-indiziert mit exklusiven Endindizes aus der in dem benutzerdefinierten Inhalts-Dokument bereitgestellten content-Liste.

Token-Kosten

• Das Aktivieren von Zitaten führt zu einem leichten Anstieg der Eingabe-Token aufgrund von Systemprompt-Ergänzungen und Dokument-Aufteilung.
• Die Zitat-Funktion ist jedoch sehr effizient mit Ausgabe-Token. Unter der Haube gibt das Modell Zitate in einem standardisierten Format aus, die dann in zitierten Text und Dokument-Standort-Indizes geparst werden. Das cited_text-Feld wird zur Bequemlichkeit bereitgestellt und zählt nicht zu den Ausgabe-Token.
• Wenn es in nachfolgenden Gesprächsrunden zurückgegeben wird, wird cited_text 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 Zitat-Blöcke können nicht direkt gecacht werden, aber die Quelldokumente, auf die sie verweisen, können gecacht werden. Um die Leistung zu optimieren, wenden Sie cache_control auf Ihre Top-Level-Dokument-Inhaltsblöcke an.

import anthropic

client = anthropic.Anthropic()

# Langes Dokument-Inhalt (z.B. technische Dokumentation)
long_document = "Dies ist ein sehr langes Dokument mit Tausenden von Wörtern..." + " ... " * 1000  # Minimale cacheable Länge

response = client.messages.create(
    model="claude-sonnet-4-5",
    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 den Dokument-Inhalt
                },
                {
                    "type": "text",
                    "text": "Was sagt dieses Dokument über API-Funktionen?"
                }
            ]
        }
    ]
)

In diesem Beispiel:

• Der Dokument-Inhalt wird mit cache_control auf dem Dokument-Block gecacht
• Zitate sind auf dem Dokument aktiviert
• Claude kann Antworten mit Zitaten generieren, während es von gecachtem Dokument-Inhalt profitiert
• Nachfolgende Anfragen mit demselben Dokument profitieren vom gecachten Inhalt

Dokumenttypen

Auswahl eines Dokumenttyps

Wir unterstützen drei Dokumenttypen für Zitate. Dokumente können direkt in der Nachricht bereitgestellt werden (base64, Text oder URL) 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 per Referenz mit ihrer file_id bereitstellen:

PDF-Dokumente

PDF-Dokumente können als base64-kodierte Daten oder per file_id bereitgestellt werden. PDF-Text wird extrahiert und in Sätze aufgeteilt. Da Bild-Zitate 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 Zitat-Granularität. Keine zusätzliche Aufteilung wird vorgenommen und Chunks werden dem Modell entsprechend den bereitgestellten Inhaltsblöcken zur Verfügung gestellt.

{
    "type": "document",
    "source": {
        "type": "content",
        "content": [
            {"type": "text", "text": "Erster Chunk"},
            {"type": "text", "text": "Zweiter Chunk"}
        ]
    },
    "title": "Dokument-Titel", # optional
    "context": "Kontext über das Dokument, das nicht zitiert wird", # optional
    "citations": {"enabled": True}
}

Antwort-Struktur

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

{
    "content": [
        {
            "type": "text",
            "text": "Laut dem Dokument, "
        },
        {
            "type": "text",
            "text": "ist das Gras grün",
            "citations": [{
                "type": "char_location",
                "cited_text": "Das Gras ist grün.",
                "document_index": 0,
                "document_title": "Beispiel-Dokument",
                "start_char_index": 0,
                "end_char_index": 20
            }]
        },
        {
            "type": "text",
            "text": " und "
        },
        {
            "type": "text",
            "text": "der Himmel ist blau",
            "citations": [{
                "type": "char_location",
                "cited_text": "Der Himmel ist blau.",
                "document_index": 0,
                "document_title": "Beispiel-Dokument",
                "start_char_index": 20,
                "end_char_index": 36
            }]
        },
        {
            "type": "text",
            "text": ". Informationen von Seite 5 besagen, dass ",
        },
        {
            "type": "text",
            "text": "Wasser essentiell ist",
            "citations": [{
                "type": "page_location",
                "cited_text": "Wasser ist essentiell für das Leben.",
                "document_index": 1,
                "document_title": "PDF-Dokument",
                "start_page_number": 5,
                "end_page_number": 6
            }]
        },
        {
            "type": "text",
            "text": ". Das benutzerdefinierte Dokument erwähnt ",
        },
        {
            "type": "text",
            "text": "wichtige Erkenntnisse",
            "citations": [{
                "type": "content_block_location",
                "cited_text": "Dies sind wichtige Erkenntnisse.",
                "document_index": 2,
                "document_title": "Benutzerdefiniertes Inhalts-Dokument",
                "start_block_index": 0,
                "end_block_index": 1
            }]
        }
    ]
}

Streaming-Unterstützung

Für Streaming-Antworten haben wir einen citations_delta-Typ hinzugefügt, der ein einzelnes Zitat enthält, das zur citations-Liste auf dem aktuellen text-Inhaltsblock hinzugefügt werden soll.