Les citations : tracer l'origine des reponses de Claude

Quand Claude repond a des questions basees sur des documents que vous lui fournissez, rien ne garantit a l’utilisateur final que la reponse provient bien du document et non des connaissances d’entrainement du modele. Les citations resolvent ce probleme en permettant a Claude de referencer precisement les passages de vos documents sources.

Pourquoi les citations sont essentielles

Imaginez que vous posez une question a Claude sur la formation de l’atmosphere terrestre et qu’il vous repond en detail. Sans citations, impossible de savoir si cette reponse vient d’un document que vous avez fourni ou de ses donnees d’entrainement. Les citations creent un lien de tracabilite entre chaque affirmation de Claude et le passage exact du document source.

Activer les citations

Pour activer les citations, il faut modifier la structure du bloc document dans votre message. Deux champs supplementaires sont necessaires :

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

title : donne un nom lisible a votre document
citations: {"enabled": true} : indique a Claude qu’il doit suivre l’origine de chaque information

Comprendre la structure d’une citation

Lorsque les citations sont activees, la reponse de Claude n’est plus un simple texte. Elle contient des donnees structurees avec les informations de citation pour chaque affirmation.

Chaque citation comprend :

Champ	Description
`cited_text`	Le texte exact du document qui appuie l’affirmation de Claude
`document_index`	L’index du document reference (utile avec plusieurs documents)
`document_title`	Le titre que vous avez attribue au document
`start_page_number`	Page de debut du texte cite
`end_page_number`	Page de fin du texte cite

Construire des interfaces utilisateur

La vraie puissance des citations se revele quand on construit des interfaces interactives. On peut par exemple ajouter des marqueurs cliquables ou survolables qui affichent le passage source exact.

L’utilisateur peut ainsi :

Verifier que les reponses de Claude sont fondees sur le document reel
Consulter le document original pour approfondir un point
Comprendre le contexte autour de chaque information citee

Citations avec du texte brut

Les citations ne sont pas limitees aux PDF. Elles fonctionnent aussi avec des sources en texte brut. La structure change legerement :

{
    "type": "document",
    "source": {
        "type": "text",
        "media_type": "text/plain",
        "data": article_text
    },
    "title": "earth_article",
    "citations": { "enabled": true }
}

Avec du texte brut, au lieu de numeros de page, vous obtenez des positions de caracteres qui indiquent precisement ou dans le texte Claude a trouve chaque information.

Quand utiliser les citations

Les citations sont particulierement utiles dans ces situations :

Les utilisateurs doivent verifier la fiabilite des informations
Vous travaillez avec des documents de reference que les utilisateurs doivent pouvoir consulter
La transparence sur les sources est critique pour votre application
Les utilisateurs souhaitent explorer le contexte autour de faits specifiques

En implementant les citations, vous transformez Claude d’une “boite noire” en un assistant de recherche transparent qui montre ses sources. Cela renforce la confiance des utilisateurs et leur permet de creuser plus loin dans vos documents quand c’est necessaire.