Aller au contenu principal
Leçon 28 sur 95 · Construire avec l'API Claude

Fournir des exemples

Leçon 28 sur 95 Mis à jour le 5 novembre 2026 Développeur
Sur cette page
  1. Montrer plutôt que décrire
  2. Quand en donner
  3. Puiser dans vos évaluations
  4. Bonnes pratiques
  5. À vous de jouer
  6. Points clés à retenir

Donner des exemples dans le prompt est l’une des techniques les plus efficaces : on montre au lieu de décrire. Avec un exemple, on parle de one-shot ; avec plusieurs, de multi-shot. Cette leçon montre comment les choisir, les structurer avec des balises, les commenter, et les puiser dans les résultats de vos évaluations.

Montrer plutôt que décrire

Le cours officiel prend un classement de sentiment de tweets, positif ou négatif. La difficulté est le sarcasme : « Ouais, bien sûr, le meilleur film que j’aie vu depuis Plan 9 from Outer Space » a l’air positif, mais il est négatif, Plan 9 étant réputé comme l’un des pires films jamais tournés. Plutôt que d’expliquer longuement le sarcasme, on ajoute des exemples :

Voici des exemples d'entrées avec la réponse idéale.

<sample_input>Super match ce soir !</sample_input>
<ideal_output>Positif</ideal_output>

<sample_input>Oh oui, j'avais vraiment besoin d'un vol retardé ce soir ! Excellent !</sample_input>
<ideal_output>Négatif</ideal_output>

Attention au sarcasme : un vocabulaire positif peut porter un message négatif.

Un exemple clairement positif, un exemple sarcastique, et une phrase de contexte : Claude sait désormais comment traiter le cas difficile. Les balises <sample_input> et <ideal_output> disent sans ambiguïté ce que représente chaque partie.

D'où viennent les bons exemples Quatre étapes : repérer l'échec fréquent (le sarcasme), choisir des exemples qui le couvrent ou reprendre les sorties les mieux notées de l'évaluation, les baliser, expliquer pourquoi la sortie est idéale. EXEMPLES D'où viennent les bons exemples 1 L'échec ex. un tweet sarcastique mal classé 2 Le choix cas limite, ou sortie notée 10 par l'évaluation 3 Les balises sample_input, ideal_output 4 Le pourquoi dire ce qui rend la sortie idéale Un exemple pose le modèle ; plusieurs, variés, couvrent les cas différents sans faire recopier un détail.
D'après la leçon « Providing examples » (Claude Academy, Building with the Claude API).

Quand en donner

  • Pour couvrir des cas limites ou des situations délicates.
  • Pour définir un format de sortie complexe, une structure JSON particulière par exemple.
  • Pour montrer exactement le style ou le ton voulu.
  • Pour indiquer comment traiter des entrées ambiguës.

Un exemple suffit à poser un modèle ; plusieurs couvrent des cas différents ou montrent plusieurs réponses valides. La documentation recommande des exemples pertinents, variés, et balisés.

Puiser dans vos évaluations

Les meilleurs exemples sont souvent déjà sous vos yeux : dans le rapport de votre évaluation, repérez les sorties qui ont obtenu la meilleure note, et reprenez ces couples entrée et sortie comme exemples dans le prompt. Claude voit alors à quoi ressemble une réponse parfaite pour votre tâche.

Et ne vous contentez pas du couple : dites pourquoi la sortie est bonne.

<ideal_output>
[la sortie notée 10 par votre évaluation]
</ideal_output>
Cet exemple est bien structuré, détaille les aliments et les quantités,
et respecte l'objectif et les restrictions de l'athlète.

Cette explication aide Claude à comprendre ce qui fait la qualité de la réponse, pas seulement sa forme.

Bonnes pratiques

  • Structurez toujours vos exemples avec des balises.
  • Annoncez-les explicitement : « Voici un exemple d’entrée avec sa réponse idéale ».
  • Choisissez des exemples qui ciblent vos échecs les plus fréquents.
  • Expliquez pourquoi la sortie d’exemple est idéale.
  • Gardez des exemples proches de la tâche réelle, et variés, pour éviter que Claude ne copie un détail accidentel.

À vous de jouer

Le sarcasme. Classez dix tweets, dont trois sarcastiques, d’abord sans exemples, puis avec les deux exemples ci-dessus. Combien de sarcasmes sont mal classés dans chaque cas ?

Des exemples tirés de l’évaluation. Dans le rapport de votre évaluation du plan de repas, prenez la sortie la mieux notée, ajoutez-la au prompt comme exemple commenté, et relancez. Vérifiez que la note monte sans que les sorties se mettent à recopier l’exemple.

Sources officielles : Providing examples (Claude Academy) · Prompting best practices (documentation Claude : exemples pertinents, variés et balisés)

Points clés à retenir

  • Un ou plusieurs exemples montrent ce qu’aucune description ne dit aussi bien : cas limites, format, ton.
  • Balisez-les (<sample_input>, <ideal_output>) et annoncez-les.
  • Les meilleures sorties de vos évaluations font d’excellents exemples ; dites pourquoi elles sont bonnes.
  • Des exemples variés et proches de la tâche réelle évitent les copies accidentelles.