Citations : réponses sourcées automatiquement

Les citations dans l'API Claude

La fonctionnalité Citations permet à Claude de référencer précisément les passages des documents sources dans ses réponses. Chaque affirmation peut être tracée jusqu'à son origine, éliminant le besoin de vérification manuelle.

Activation

Ajoutez simplement le paramètre citations dans votre requête :

const response = await client.messages.create({
  model: "claude-sonnet-4-20250514",
  max_tokens: 1024,
  messages: [
    {
      role: "user",
      content: [
        {
          type: "document",
          source: {
            type: "text",
            media_type: "text/plain",
            data: "Le contenu de votre document ici..."
          },
          title: "Politique RH 2024",
          citations: { enabled: true }
        },
        {
          type: "text",
          text: "Quel est le nombre de jours de congés ?"
        }
      ]
    }
  ]
});

Format de la réponse

La réponse contient des blocs de texte intercalés avec des citations :

{
  "content": [
    {
      "type": "text",
      "text": "Selon la politique RH, les employés disposent de "
    },
    {
      "type": "cite",
      "text": "25 jours ouvrés de congés payés par an",
      "document_title": "Politique RH 2024",
      "start_char_index": 1250,
      "end_char_index": 1295
    },
    {
      "type": "text",
      "text": ", ce qui correspond au minimum légal plus 5 jours supplémentaires."
    }
  ]
}

Types de documents supportés

• text/plain : Texte brut
• application/pdf : Documents PDF (encodés en base64)
• text/html : Pages web
• text/markdown : Documents markdown

Cas d'usage principaux

1. Assistant documentaire Permet aux utilisateurs de poser des questions sur des documents internes avec traçabilité complète.

2. Vérification factuelle Chaque affirmation est liée à sa source, facilitant l'audit.

3. Résumés sourcés Générer des résumés où chaque point peut être vérifié dans le document original.

4. RAG vérifiable Dans un pipeline RAG, les citations prouvent que la réponse vient bien des documents récupérés.

Bonnes pratiques

• Documents structurés : Les documents bien formatés (avec titres, sections) produisent de meilleures citations
• Titres descriptifs : Utilisez le champ title pour que les citations soient identifiables
• Multi-documents : Vous pouvez fournir plusieurs documents, Claude citera chacun séparément
• Affichage UX : Utilisez les index de caractères pour implémenter un surlignage dans le document source