Citations

Claude est capable de fournir des citations détaillées lorsqu’il répond à des questions sur des documents, vous aidant ainsi à suivre et à vérifier les sources d’information dans les réponses.

La fonctionnalité de citations est actuellement disponible sur Claude 3.7 Sonnet, Claude 3.5 Sonnet (nouveau) et 3.5 Haiku.

Voici un exemple d’utilisation des citations avec l’API Messages :

​

Comment fonctionnent les citations

Intégrez les citations avec Claude en suivant ces étapes :

​

Contenu citable vs non citable

• Le texte trouvé dans le contenu source d’un document peut être cité.
• title et context sont des champs facultatifs qui seront transmis au modèle mais ne seront pas utilisés pour le contenu cité.
• title est limité en longueur, donc vous pourriez trouver utile d’utiliser le champ context pour stocker les métadonnées du document sous forme de texte ou de json stringifié.

​

Indices de citation

• Les indices de document sont indexés à partir de 0 dans la liste de tous les blocs de contenu de document dans la requête (couvrant tous les messages).
• Les indices de caractères sont indexés à partir de 0 avec des indices de fin exclusifs.
• Les numéros de page sont indexés à partir de 1 avec des numéros de page de fin exclusifs.
• Les indices de blocs de contenu sont indexés à partir de 0 avec des indices de fin exclusifs provenant de la liste content fournie dans le document à contenu personnalisé.

​

Coûts en tokens

• L’activation des citations entraîne une légère augmentation des tokens d’entrée en raison des ajouts de prompts système et du découpage des documents.
• Cependant, la fonctionnalité de citations est très efficace avec les tokens de sortie. En coulisses, le modèle produit des citations dans un format standardisé qui sont ensuite analysées en texte cité et en indices d’emplacement de document. Le champ cited_text est fourni pour des raisons de commodité et n’est pas comptabilisé dans les tokens de sortie.
• Lorsqu’il est renvoyé dans les tours de conversation suivants, cited_text n’est pas non plus comptabilisé dans les tokens d’entrée.

​

Compatibilité des fonctionnalités

Les citations fonctionnent en conjonction avec d’autres fonctionnalités de l’API, y compris la mise en cache des prompts, le comptage des tokens et le traitement par lots.

​

Types de documents

​

Choisir un type de document

Nous prenons en charge trois types de documents pour les citations :

​

Documents en texte brut

Les documents en texte brut sont automatiquement découpés en phrases :

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

{
    "type": "char_location",
    "cited_text": "The exact text being cited", # non comptabilisé dans les tokens de sortie
    "document_index": 0,
    "document_title": "Document Title",
    "start_char_index": 0,    # indexé à partir de 0
    "end_char_index": 50      # exclusif
}

​

Documents PDF

Les documents PDF sont fournis sous forme de données encodées en base64. Le texte PDF est extrait et découpé en phrases. Comme les citations d’images ne sont pas encore prises en charge, les PDF qui sont des numérisations de documents et ne contiennent pas de texte extractible ne seront pas citables.

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

{
    "type": "page_location",
    "cited_text": "The exact text being cited", # non comptabilisé dans les tokens de sortie
    "document_index": 0,     
    "document_title": "Document Title", 
    "start_page_number": 1,  # indexé à partir de 1
    "end_page_number": 2     # exclusif
}

​

Documents à contenu personnalisé

Les documents à contenu personnalisé vous donnent un contrôle sur la granularité des citations. Aucun découpage supplémentaire n’est effectué et les fragments sont fournis au modèle selon les blocs de contenu fournis.

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

{
    "type": "content_block_location",
    "cited_text": "The exact text being cited", # non comptabilisé dans les tokens de sortie
    "document_index": 0,
    "document_title": "Document Title",
    "start_block_index": 0,   # indexé à partir de 0
    "end_block_index": 1      # exclusif
}

​

Structure de réponse

Lorsque les citations sont activées, les réponses incluent plusieurs blocs de texte avec des citations :

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

​

Support du streaming

Pour les réponses en streaming, nous avons ajouté un type citations_delta qui contient une seule citation à ajouter à la liste citations sur le bloc de contenu text actuel.

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