Lorsque Claude répond à des questions en se basant sur des documents que vous fournissez, les utilisateurs pourraient supposer qu'il se contente de puiser des informations dans ses données d'entraînement. Mais que se passe-t-il si Claude cite réellement des sources spécifiques ? La fonctionnalité de citations vous permet de montrer aux utilisateurs exactement où Claude a trouvé ses informations, instaurant ainsi 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 provenant 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 matériel 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 un nom à votre document qui apparaît dans les citations. Le champ citations avec enabled: True indique à Claude de suivre 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 que Claude référence depuis 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ù le texte cité commence
- end_page_number - Où le texte cité se termine
Créer des interfaces de citation
La véritable puissance des citations réside dans la création d'interfaces utilisateur qui les affichent. Vous pouvez créer des références numérotées dans le texte qui renvoient à 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 en 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, vous permettant de mettre en évidence les phrases ou paragraphes exacts que Claude a référencés.
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 matériel source original
En implémentant 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.