Citations

Quand vous travaillez avec des PDF, l’un des plus grands défis n’est pas technique — c’est la confiance. Les utilisateurs doivent souvent croire sur parole que l’IA interprète correctement le contenu du document : le résumé est-il fidèle ? cette affirmation figure-t-elle vraiment dans le rapport ? La fonctionnalité de citations de Claude résout ce problème à la racine, en montrant exactement d’où vient chaque information.

Activer les citations

L’activation ne demande qu’un seul paramètre dans la configuration de votre document :

with open("./earth.pdf", "rb") as f:
    file_bytes = f.read()

messages = []
add_user_message(
    messages,
    [
        {
            "document": {
                "format": "pdf",
                "name": "earth",
                "source": {"bytes": file_bytes},
                "citations": {"enabled": True}
            }
        },
        {"text": "Comment l'atmosphère et les oceans de la Terre se sont-ils formes ?"},
    ]
)

response = chat(messages)

La structure vous est familière depuis la leçon PDF ; l’ajout clé tient sur une ligne : "citations": {"enabled": True} dans le dictionnaire du document. Notez que l’activation est par document — dans une requête qui en joint plusieurs, vous choisissez lesquels doivent citer leurs sources, et le champ "name" prend ici toute son importance : c’est lui qui identifiera le document dans chaque citation.

Comprendre les réponses avec citations

Quand les citations sont activées, la structure de réponse de Claude change. Au lieu de renvoyer uniquement du texte, vous obtenez une alternance de parties :

• Parties texte : le contenu de réponse habituel
• Parties citations : données structurées qui font le lien entre les affirmations et les emplacements dans la source

Concrètement, la réponse se lit comme un texte entrecoupé de justificatifs : un passage d’explication, puis la référence qui le fonde, puis la suite. Chaque citation inclut des informations détaillées sur l’endroit où Claude a trouvé les preuves : le document spécifique, les numéros de page, et même le texte exact qui a influencé sa réponse. Votre code d’affichage doit donc parcourir ces parties et décider du rendu — notes de bas de page, info-bulles au survol, liens qui ouvrent le PDF à la bonne page : toutes les données nécessaires sont là.

Pourquoi les citations comptent

Les bénéfices se renforcent l’un l’autre. La vérification, d’abord : les utilisateurs peuvent contrôler le travail de Claude en retournant à la source — la réponse cesse d’être une boîte noire. La confiance en découle : savoir d’où viennent les informations change le statut de l’application, d’un chatbot qui affirme à un assistant qui documente. La transparence y gagne aussi : le processus de raisonnement devient visible et auditable — un argument décisif dans les organisations soumises à des exigences de conformité. Et un effet moins attendu : la précision elle-même s’améliore, car l’obligation de citer encourage une extraction d’informations plus soigneuse — difficile d’affirmer approximativement quand chaque phrase doit désigner son passage source.

Cette fonctionnalité est particulièrement précieuse dans les contextes professionnels, académiques ou de recherche où la précision et l’attribution des sources sont critiques : analyse de contrats, revue de littérature, conformité réglementaire. Partout où l’on demanderait à un humain « d’où tiens-tu cela ? », les citations donnent à Claude le moyen de répondre.

Points clés à retenir

• Un seul ajout active le suivi des sources : "citations": {"enabled": True} sur le document
• L’activation est par document ; le champ "name" identifie la source dans chaque citation
• La réponse devient une alternance texte/citations : document, pages, texte exact à l’appui
• Vérifiabilité, confiance, auditabilité — et une extraction plus soigneuse par construction
• Indispensable dès que l’attribution des sources compte : juridique, recherche, conformité