Lorsque Claude répond à des questions en se basant sur des documents que vous fournissez, les utilisateurs pourraient supposer qu'il s'appuie simplement sur ses données d'entraînement. Mais que se passerait-il si Claude pouvait montrer exactement où il a trouvé une information spécifique ? C'est là qu'interviennent les citations - une fonctionnalité puissante qui permet à Claude de référencer des parties spécifiques de vos documents source et de montrer aux utilisateurs exactement d'où provient chaque élément d'information.
Pourquoi les citations sont importantes
Imaginez que vous demandiez à Claude comment l'atmosphère terrestre s'est formée et que vous obteniez une réponse détaillée. Sans citations, les utilisateurs n'ont aucun moyen de vérifier l'information ou de comprendre que Claude fait réellement référence à un document spécifique que vous avez fourni. Les citations résolvent ce problème de transparence en créant une piste claire entre la réponse de Claude et votre matériel source.
Activer les citations
Pour activer les citations, vous devez modifier la structure de votre message de document. Ajoutez deux nouveaux champs à votre bloc 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 lisible, tandis que citations: {"enabled": True} indique à Claude de suivre l'endroit où il trouve les informations.
Comprendre la 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 des données structurées qui incluent des informations de citation pour chaque affirmation.
Chaque citation contient plusieurs éléments d'information clés :
- cited_text - Le texte exact de votre document qui étaye l'affirmation de Claude
- document_index - Le document auquel Claude fait référence (utile lorsque vous fournissez plusieurs documents)
- 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é
Créer des interfaces utilisateur avec les citations
La véritable puissance des citations réside dans la création d'interfaces utilisateur qui rendent cette information accessible. Vous pouvez créer des éléments interactifs où les utilisateurs peuvent survoler les marqueurs de citation pour voir exactement d'où provient l'information.
Cela crée une expérience transparente où les utilisateurs peuvent :
- Constater que les réponses de Claude sont ancrées dans un matériel source réel
- Vérifier l'information en consultant le document original
- Comprendre le contexte autour de chaque élément d'information cité
Citations avec du texte brut
Les citations ne se limitent pas aux documents PDF. Vous pouvez également les utiliser avec des sources en texte brut. Lorsque vous travaillez avec du texte, modifiez votre structure de document comme suit :
{
"type": "document",
"source": {
"type": "text",
"media_type": "text/plain",
"data": article_text,
},
"title": "earth_article",
"citations": { "enabled": True }
}Avec les sources en texte brut, au lieu de numéros de page, vous obtiendrez des positions de caractères qui indiquent précisément où, dans le texte, Claude a trouvé chaque élément d'information.
Quand utiliser les citations
Les citations sont particulièrement utiles lorsque :
- Les utilisateurs doivent vérifier l'exactitude des informations
- Vous travaillez avec des documents faisant autorité que les utilisateurs devraient pouvoir référencer
- La transparence sur les sources d'information est essentielle pour votre application
- Les utilisateurs pourraient vouloir explorer le contexte plus large autour de faits spécifiques
En mettant en œuvre les citations, vous transformez Claude d'une « boîte noire » qui fournit des réponses en un assistant de recherche transparent qui montre son travail. Cela renforce la confiance des utilisateurs et leur permet d'approfondir vos matériaux source lorsque nécessaire.