Zitate

Claude kann detaillierte Zitate bereitstellen, wenn Fragen zu Dokumenten beantwortet werden, um Ihnen 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:

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-opus-4-6",
    "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?"
          }
        ]
      }
    ]
  }'

Wie Zitate funktionieren

Integrieren Sie Zitate mit Claude in diesen Schritten:

Zitierbare vs. nicht zitierbare Inhalte

• Text, der sich in den source-Inhalten 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 können Sie das context-Feld nützlich finden, 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.
• Seitennummern sind 1-indiziert mit exklusiven Endseitennummern.
• 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 Systemaufforderungsergänzungen und Dokumentchunking.
• Die Zitate-Funktion ist jedoch sehr effizient mit Ausgabe-Token. Unter der Haube gibt das Modell Zitate in einem standardisierten Format aus, das dann in zitiertem Text und Dokumentort-Indizes analysiert wird. Das cited_text-Feld wird zur Bequemlichkeit 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.

import anthropic

client = anthropic.Anthropic()

# Long document content (e.g., technical documentation)
long_document = "This is a very long document with thousands of words..." + " ... " * 1000  # Minimum cacheable length

response = client.messages.create(
    model="claude-opus-4-6",
    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?"
                }
            ]
        }
    ]
)

In diesem Beispiel:

• Der Dokumentinhalt wird mit cache_control auf dem Dokumentblock zwischengespeichert
• Zitate sind auf dem 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

Wir unterstützen drei Dokumenttypen für Zitate. 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 Zitgranularitä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 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.