Lorsque Claude répond à des questions en se basant sur des documents que vous fournissez, les utilisateurs pourraient penser qu'il ne fait que puiser dans ses données d'entraînement. Mais que se passe-t-il si Claude cite en réalité des sources spécifiques ? La fonctionnalité Citations vous permet de montrer aux utilisateurs exactement où Claude a trouvé ses informations, ce qui instaure confiance et transparence dans vos applications d'IA.
Pourquoi les Citations sont importantes
Sans citations, les utilisateurs perçoivent les réponses de Claude comme venant de sa mémoire. Ils n'ont aucun moyen de vérifier l'information ou de comprendre qu'elle repose sur des documents spécifiques que vous avez fournis. Les citations résolvent ce problème en montrant aux utilisateurs le document source exact que Claude a utilisé pour générer chaque partie de sa réponse.
Activer les Citations
Pour activer les citations, ajoutez deux champs à votre message de document :
{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": file_bytes,
},
"title": "earth.pdf",
"citations": { "enabled": True }
}Le champ title donne à votre document un nom qui apparaît dans les citations. Le champ citations avec enabled: True indique à Claude de suivre l'endroit où il trouve les informations.
Structure des citations
Lorsque les citations sont activées, la réponse de Claude devient plus complexe. Au lieu d'un simple texte, vous obtenez un contenu structuré avec des informations de citation :

Chaque citation contient :
- cited_text - Le texte exact auquel Claude fait référence dans votre document
- document_index - Quel document (si vous en avez fourni plusieurs)
- document_title - Le titre que vous avez attribué au document
- start_page_number - Où commence le texte cité
- end_page_number - Où se termine le texte cité
Construire des interfaces de citation
Toute la puissance des citations réside dans la construction d'interfaces utilisateur qui les affichent. Vous pouvez créer des références numérotées dans le texte qui renvoient vers des informations de citation détaillées :

Lorsque les utilisateurs survolent ou cliquent sur les numéros de citation, ils voient exactement quel document et quelles pages Claude a référencés. Cette transparence aide les utilisateurs à vérifier les informations et renforce la confiance dans les réponses de Claude.
Citations avec du texte brut
Les citations ne se limitent pas aux PDF. Vous pouvez également les utiliser avec des documents texte brut :
{
"type": "document",
"source": {
"type": "text",
"media_type": "text/plain",
"data": article_text,
},
"title": "earth article",
"citations": { "enabled": True }
}Avec du texte brut, vous obtenez des objets CitationCharLocation au lieu d'emplacements de page. Ceux-ci fournissent des positions de caractères dans le texte, ce qui permet de mettre en évidence les phrases ou paragraphes exacts auxquels Claude a fait référence.
Quand utiliser les Citations
Les citations sont essentielles lorsque :
- Les utilisateurs doivent vérifier l'exactitude des informations
- Vous travaillez avec des documents sensibles ou importants
- La transparence sur les sources renforce la confiance dans votre application
- Les utilisateurs pourraient vouloir lire le document source original
En mettant en œuvre les citations, vous transformez Claude d'une « boîte noire » qui donne des réponses en un système transparent qui montre son travail, rendant vos applications d'IA plus fiables et vérifiables.