Zitierungen

Claude ist in der Lage, detaillierte Zitierungen bei der Beantwortung von Fragen zu Dokumenten bereitzustellen, was Ihnen hilft, Informationsquellen in Antworten nachzuverfolgen und zu überprüfen.

Die Zitierungsfunktion ist derzeit verfügbar für Claude 3.7 Sonnet, Claude 3.5 Sonnet (neu) und 3.5 Haiku.

Hier ist ein Beispiel, wie Sie Zitierungen mit der Messages API verwenden können:

​

Wie Zitierungen funktionieren

Integrieren Sie Zitierungen mit Claude in diesen Schritten:

​

Zitierbarer vs. nicht-zitierbarer Inhalt

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

​

Zitierungsindizes

• Dokumentindizes beginnen bei 0 aus der Liste aller Dokumentinhaltsblöcke in der Anfrage (über alle Nachrichten hinweg).
• Zeichenindizes beginnen bei 0 mit exklusiven Endindizes.
• Seitenzahlen beginnen bei 1 mit exklusiven Endseitenzahlen.
• Inhaltsblockindizes beginnen bei 0 mit exklusiven Endindizes aus der im benutzerdefinierten Inhaltsdokument bereitgestellten content-Liste.

​

Token-Kosten

• Die Aktivierung von Zitierungen führt zu einem leichten Anstieg der Eingabe-Tokens aufgrund von Systemprompterweiterungen und Dokumentunterteilung.
• Die Zitierungsfunktion ist jedoch sehr effizient mit Ausgabe-Tokens. Im Hintergrund gibt das Modell Zitierungen in einem standardisierten Format aus, die dann in zitierten Text und Dokumentpositionsindizes umgewandelt werden. Das Feld cited_text wird zur Vereinfachung bereitgestellt und zählt nicht zu den Ausgabe-Tokens.
• Wenn es in nachfolgenden Gesprächsrunden zurückgegeben wird, wird cited_text auch nicht zu den Eingabe-Tokens gezählt.

​

Funktionskompatibilität

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

​

Dokumenttypen

​

Auswahl eines Dokumenttyps

Wir unterstützen drei Dokumenttypen für Zitierungen:

​

Nur-Text-Dokumente

Nur-Text-Dokumente werden automatisch in Sätze unterteilt:

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

{
    "type": "char_location",
    "cited_text": "The exact text being cited", # not counted towards output tokens
    "document_index": 0,
    "document_title": "Document Title",
    "start_char_index": 0,    # 0-indexed
    "end_char_index": 50      # exclusive
}

​

PDF-Dokumente

PDF-Dokumente werden als base64-kodierte Daten bereitgestellt. PDF-Text wird extrahiert und in Sätze unterteilt. Da Bildzitierungen noch nicht unterstützt werden, können PDFs, die Scans von Dokumenten sind und keinen extrahierbaren Text enthalten, nicht zitiert werden.

{
    "type": "document",
    "source": {
        "type": "base64",
        "media_type": "application/pdf",
        "data": base64_encoded_pdf_data
    },
    "title": "Document Title", # optional
    "context": "Context about the document that will not be cited from", # optional
    "citations": {"enabled": True}
}

{
    "type": "page_location",
    "cited_text": "The exact text being cited", # not counted towards output tokens
    "document_index": 0,     
    "document_title": "Document Title", 
    "start_page_number": 1,  # 1-indexed
    "end_page_number": 2     # exclusive
}

​

Dokumente mit benutzerdefinierten Inhalten

Dokumente mit benutzerdefinierten Inhalten geben Ihnen Kontrolle über die Zitierungsgranularität. Es erfolgt keine zusätzliche Unterteilung, und die Chunks werden dem Modell gemäß den bereitgestellten Inhaltsblöcken zur Verfügung gestellt.

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

{
    "type": "content_block_location",
    "cited_text": "The exact text being cited", # not counted towards output tokens
    "document_index": 0,
    "document_title": "Document Title",
    "start_block_index": 0,   # 0-indexed
    "end_block_index": 1      # exclusive
}

​

Antwortstruktur

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

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

​

Streaming-Unterstützung

Für Streaming-Antworten haben wir einen citations_delta-Typ hinzugefügt, der eine einzelne Zitierung enthält, die der citations-Liste des aktuellen text-Inhaltsblocks hinzugefügt werden soll.

event: message_start
data: {"type": "message_start", ...}

event: content_block_start
data: {"type": "content_block_start", "index": 0, ...}

event: content_block_delta
data: {"type": "content_block_delta", "index": 0, 
       "delta": {"type": "text_delta", "text": "According to..."}}

event: content_block_delta
data: {"type": "content_block_delta", "index": 0,
       "delta": {"type": "citations_delta", 
                 "citation": {
                     "type": "char_location",
                     "cited_text": "...",
                     "document_index": 0,
                     ...
                 }}}

event: content_block_stop
data: {"type": "content_block_stop", "index": 0}

event: message_stop
data: {"type": "message_stop"}