Fournir des exemples
Sur cette page
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.
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.