Les citations

Quand Claude répond à partir d’un document, une question reste en suspens : où exactement a-t-il trouvé cela ? Les citations y répondent nativement — elles permettent de montrer aux utilisateurs exactement d’où Claude a tiré ses informations, passage par passage, renforçant la confiance et la transparence. Au lieu d’une réponse à croire sur parole, on obtient une réponse vérifiable, chaque affirmation reliée à son extrait source.

Activer les citations

L’activation se fait au niveau du bloc document, dans la requête :

{
    "type": "document",
    "source": {
        "type": "base64",
        "media_type": "application/pdf",
        "data": file_bytes,
    },
    "title": "rapport.pdf",
    "citations": {"enabled": True}
}

Deux champs font le travail. Le champ title nomme le document dans les citations — c’est ce libellé que vos utilisateurs verront comme source, choisissez-le parlant. Le champ citations active le suivi des sources : dès lors, la réponse de Claude n’est plus un simple flux de texte, mais une alternance de passages libres et de passages cités, chacun portant ses références.

Structure d’une citation

Chaque citation contient :

• cited_text : le texte exact référencé depuis le document
• document_index : quel document (si plusieurs)
• document_title : le titre attribué
• start_page_number et end_page_number : localisation dans le document

Tout y est pour construire une interface de vérification : le cited_text permet d’afficher l’extrait exact au survol, les numéros de pages d’ouvrir le PDF au bon endroit, le document_index de s’y retrouver quand la requête joint plusieurs documents. Point important : ces localisations sont produites par le mécanisme de citation lui-même, qui ancre chaque passage cité dans le document — pas une reconstruction a posteriori que le modèle pourrait inventer.

Citations avec du texte brut

Les citations ne sont pas réservées aux PDF ; elles fonctionnent aussi avec les documents texte :

{
    "type": "document",
    "source": {
        "type": "text",
        "media_type": "text/plain",
        "data": article_text,
    },
    "title": "article terre",
    "citations": {"enabled": True}
}

La différence se joue dans le format de localisation : avec du texte brut, vous recevez des CitationCharLocation — des positions de caractères — au lieu de numéros de pages. C’est même plus précis : de quoi surligner le passage exact dans votre interface, au caractère près, là où la page ne donnait qu’une zone.

Quand utiliser les citations

Les citations s’imposent chaque fois que la réponse engage quelque chose : quand les utilisateurs doivent pouvoir vérifier la précision des informations, quand on travaille avec des documents sensibles ou importants — contrats, rapports financiers, dossiers médicaux —, quand la transparence sur les sources conditionne la confiance dans l’application, ou simplement quand les utilisateurs voudront consulter le matériel source original pour aller plus loin. Le surcoût d’implémentation est minime — un champ dans la requête, un rendu à soigner — pour un gain de crédibilité qui change le statut de l’application : d’un chatbot qui affirme, on passe à un assistant qui documente.

Points clés à retenir

• Les citations relient chaque affirmation de Claude à l’extrait exact du document source
• Activation par document : "citations": {"enabled": True} + un title parlant
• Chaque citation porte le texte cité, le document, et sa localisation (pages ou positions de caractères)
• Texte brut → CitationCharLocation, plus précis que les pages : surlignage au caractère près
• À activer dès que la vérifiabilité compte : documents sensibles, confiance à établir, sources à consulter