Chargement

Fournir des exemples

Leçon 195 min
Chargement

Fournir des exemples dans vos requêtes est l'une des techniques d'ingénierie de requêtes les plus efficaces que vous utiliserez. Cette approche, connue sous le nom de requêtage « one-shot » ou « multi-shot », consiste à donner à Claude des paires d'entrée/sortie d'exemple pour guider ses réponses.

Comment fonctionnent les exemples

Examinons un exemple d'analyse de sentiment. Supposons que vous souhaitiez que Claude catégorise un tweet comme positif ou négatif :

La requête pour le tweet cité ci-dessous : elle enveloppe le tweet dans des balises input_tweet et demande « Positive » ou « Negative ».

Le défi ici est le sarcasme. Un tweet comme « Ouais, bien sûr, c'était le meilleur film que j'aie vu depuis 'Plan 9 from Outer Space' » semble positif en surface, mais il est en réalité sarcastique et négatif (Plan 9 est réputé être l'un des pires films jamais réalisés).

Ajouter des exemples pour gérer les cas particuliers

Pour résoudre ce problème, vous pouvez ajouter des exemples qui montrent à Claude comment gérer les cas délicats :

La requête d'analyse de sentiment, désormais avec deux exemples : « Great game tonight! » devenant « Positive » et un tweet sarcastique devenant « Negative ».

La requête améliorée inclut :

  • Un exemple positif clair : « Great game tonight! » → « Positive »
  • Un exemple sarcastique : « Oh yeah, I really needed a flight delay tonight! Excellent! » → « Negative »
  • Un contexte expliquant pourquoi le sarcasme doit être traité avec attention

Remarquez comment les exemples sont enveloppés dans des balises XML comme <sample_input> et <ideal_output>. Cette structure rend parfaitement clair pour Claude ce que représente chaque partie.

Quand utiliser des exemples

Les exemples sont particulièrement utiles pour :

  • Capturer des cas particuliers ou des scénarios limites
  • Définir des formats de sortie complexes (comme des structures JSON spécifiques)
  • Montrer le style ou le ton exact que vous souhaitez
  • Démontrer comment gérer des entrées ambiguës

One-Shot vs Multi-Shot

One-Shot : Fournissez un seul exemple pour établir le modèle.

Multi-Shot : Fournissez plusieurs exemples pour couvrir différents scénarios.

Utilisez le multi-shot lorsque vous devez gérer divers cas particuliers ou que vous souhaitez montrer différents types de réponses valides.

Trouver de bons exemples à partir des évaluations

Lors de l'exécution d'évaluations de requêtes, recherchez vos sorties ayant obtenu le meilleur score pour les utiliser comme exemples :

Rapport d'évaluation de requête, chaque ligne donnant un cas de test de plan de repas, ses critères, la sortie de Claude et un score, ici 10 et 8.

Trouvez les réponses ayant obtenu un score de 10 (ou votre meilleur score disponible) et utilisez ces paires d'entrée/sortie comme exemples dans votre requête. Cela aide Claude à comprendre à quoi ressemble une sortie « parfaite » pour votre cas d'usage spécifique.

Ajouter du contexte aux exemples

Ne vous contentez pas de fournir la paire entrée/sortie - expliquez pourquoi la sortie est bonne :

<ideal_output>
[Your example output here]
</ideal_output>

This example is well-structured, provides detailed information 
on food choices and quantities, and aligns with the athlete's 
goals and restrictions.

Ce contexte supplémentaire aide Claude à comprendre le raisonnement derrière les bonnes réponses, et pas seulement le format.

Bonnes pratiques

  • Utilisez toujours des balises XML pour structurer clairement vos exemples
  • Soyez explicite sur ce que vous montrez : « Voici un exemple d'entrée avec une réponse idéale »
  • Incluez des exemples qui traitent vos cas d'échec les plus courants
  • Expliquez pourquoi les sorties de vos exemples sont considérées comme idéales
  • Gardez les exemples pertinents par rapport à votre tâche spécifique

Les exemples sont particulièrement puissants car ils montrent plutôt qu'ils ne se contentent de décrire. Au lieu d'essayer de décrire exactement ce que vous voulez avec des mots, vous le démontrez directement. Cela rend vos requêtes beaucoup plus fiables et aide Claude à comprendre des exigences subtiles qui pourraient être difficiles à exprimer dans des instructions seules.