Ajouter des détails concrets
Nombres, noms, formats et exemples qui structurent les résultats de l’IA.
Ajouter des détails concrets est une leçon AI Prompt Engineering gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage AI Prompt Engineering, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours AI Prompt Engineering comprend 4 leçons au total.
Les détails concrets sont des points d'ancrage
Les détails concrets sont des éléments d'information précis, mesurables et vérifiables. Ils ancrent le résultat du modèle dans votre situation réelle plutôt que dans une interprétation générique.
Sans points d'ancrage, le modèle génère un résultat pour un utilisateur moyen imaginaire. Avec des points d'ancrage, il génère un résultat pour vous.
Le nombre de mots comme contrainte concrète
Le nombre de mots est l'un des détails concrets les plus simples et les plus efficaces que vous puissiez ajouter. Comparez :
- Vague : « Rédigez une courte description »
- Concret : « Rédigez une description de 75 mots »
Le modèle comptera les jetons et visera votre objectif. S'il s'en écarte légèrement, vous pouvez lui demander de recompter exactement. Le nombre de mots élimine des catégories entières de reformulation.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{
'role': 'user',
'content': (
'Write a product description for a noise-cancelling travel pillow in exactly 60 words. '
'After the description, output the word count in parentheses on a new line.'
)
}]
)
print(response.content[0].text)Le public cible comme détail concret
Nommer un public précis et concret modifie considérablement le vocabulaire, les exemples et le niveau de détail du résultat.
- Vague : « Expliquez les réseaux neuronaux »
- Concret : « Expliquez les réseaux neuronaux à un responsable marketing d'une entreprise du classement Fortune 500 qui ne connaît pas la programmation, mais comprend les tableaux croisés dynamiques d'Excel »
La deuxième instruction donne au modèle une image mentale d'un lecteur réel et lui permet d'ajuster parfaitement la complexité.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
concrete_audience_prompt = (
'Explain what a REST API is.\n\n'
'Audience: a non-technical product manager who uses Salesforce daily '
'and understands the concept of a form submission on a website. '
'They will use this explanation to brief their engineering team tomorrow. '
'Use one real-world analogy. Max 100 words.'
)
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': concrete_audience_prompt}]
)
print(response.choices[0].message.content)Des entités nommées plutôt que des généralisations
L'utilisation d'entités nommées — noms réels de produits, d'entreprises, de personnes et de technologies, ainsi que des dates — force le modèle à sortir du domaine générique.
- Vague : « Rédigez une analyse concurrentielle »
- Concret : « Rédigez une analyse concurrentielle de Notion, d'Obsidian et de Roam Research pour un utilisateur avancé qui gère une équipe à distance de 10 personnes, écrit chaque jour et a besoin d'un accès hors ligne »
Les entités nommées ancrent le modèle dans les connaissances du monde réel acquises pendant son entraînement.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'Compare FastAPI vs Flask vs Django REST Framework '
'for building a production API that will serve a React frontend. '
'Context: 2-person startup team, Python 3.11, needs async support, '
'expects < 50 ms response time, and will deploy on AWS Lambda. '
'Format: 3-column markdown table with rows: setup complexity, '
'async support, performance, learning curve, community size.'
)
}]
)
print(response.content[0].text)Contraintes quantitatives
Les nombres ne prêtent pas à confusion. Chaque fois que vous avez une exigence numérique, indiquez-la dans l'instruction :
- Énumérez exactement N éléments (et non « quelques-uns » ou « plusieurs »)
- Nombre maximal ou minimal de mots ou de caractères
- Pourcentages ou proportions précises (« 70 % pratique, 30 % théorique »)
- Contraintes temporelles (« expliquez-le comme si je disposais de 3 minutes pour lire ceci »)
- Objectifs de performance (« suggérez des approches qui atteignent une complexité temporelle en O(n) »)
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Generate exactly 8 onboarding email subject lines for a B2B SaaS product. '
'Requirements:\n'
'- Exactly 8 lines, no more, no fewer\n'
'- Each subject line between 40 and 60 characters\n'
'- 4 must emphasize value, 4 must create urgency\n'
'- Label each line: [VALUE] or [URGENCY]\n'
'- No emojis\n'
'- No duplicate words across all 8 lines'
)
}]
)
print(response.choices[0].message.content)Échéance et contexte temporel
Fournir un contexte temporel modifie le niveau de détail et l'orientation des résultats. Dites au modèle quand ce contenu sera utilisé et quelles contraintes cela entraîne :
- « Cet e-mail sera envoyé dans 2 heures — restez bref »
- « Il s'agit d'une présentation au conseil d'administration lundi — employez un langage de niveau direction »
- « Cette explication doit tenir dans une réunion quotidienne de 5 minutes »
- « Rédigez ceci pour une équipe qui dispose de 10 minutes pour le relire avant l'appel avec le client »
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=256,
messages=[{
'role': 'user',
'content': (
'Write a project status update for our AI chatbot project. '
'This will be read aloud at a 5-minute Monday morning stand-up. '
'The audience has zero technical background. '
'Talking time: max 2 minutes (approximately 300 words). '
'Cover: what we shipped last week, one current blocker, one upcoming milestone. '
'Tone: confident and factual. No jargon.'
)
}]
)
print(response.content[0].text)Exemples précis dans le prompt
Inclure des exemples précis de ce que vous voulez ou de ce que vous ne voulez pas est l’une des techniques les plus efficaces. Les exemples enseignent simultanément le format, la voix et le style.
Vous pouvez inclure :
- Un exemple du résultat idéal (avec un seul exemple)
- Plusieurs exemples avec des étiquettes (avec quelques exemples)
- Un exemple de ce qui n’a pas fonctionné auparavant (exemple négatif)
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
prompt = '''
Write 3 feature announcement tweets for a new developer tool.
Here is an example of the style I want:
"We just shipped inline type errors in the editor. No more tab-switching to find
what broke. Your flow stays unbroken. Try it now: [link]"
Characteristics of this style:
- Opens with what shipped, not with excitement words
- Describes the user benefit in the second sentence
- Ends with a CTA
- No hashtags. No emojis. Under 200 characters.
New feature: autocomplete that learns from your codebase.
'''
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': prompt}]
)
print(response.choices[0].message.content)Vocabulaire propre au domaine
Inclure des termes propres au domaine indique au modèle le niveau d’expertise attendu dans le résultat.
- « Expliquez la mise en cache » → réponse de type generic
- « Expliquez la politique d’éviction LRU de Redis à un ingénieur du développement côté serveur qui migre de Memcached vers Redis 7.x » → réponse de niveau expert, ancrée dans le domaine
Utilisez le vocabulaire de votre domaine dans la consigne et le modèle le reprendra dans le résultat.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
# Generic prompt vs domain-vocabulary prompt
generic = 'Explain caching strategies.'
domain_anchored = (
'Compare write-through, write-behind, and cache-aside patterns '
'for a microservices architecture using Redis 7.x as the cache layer and '
'PostgreSQL 15 as the source of truth. '
'Focus on consistency guarantees, latency tradeoffs, and failure modes. '
'Audience: senior backend engineers familiar with CAP theorem.'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{'role': 'user', 'content': domain_anchored}]
)
print(response.content[0].text)Contraintes sur les éléments à exclure
Les contraintes négatives concrètes (exclusions) empêchent le modèle de suivre des orientations prévisibles et de type generic :
- « Ne suggérez pas de solutions nécessitant une clé API payante »
- « Ne mentionnez pas les concurrents par leur nom »
- « N’utilisez pas les mots “effet de levier” ou “synergie” »
- « Ne fournissez pas de contenu théorique — uniquement du contenu pratique »
- « Excluez les approches nécessitant plus de 5 minutes de mise en œuvre »
Chaque règle d’exclusion affine le résultat en éliminant une possibilité supplémentaire de contenu de type generic.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Suggest 5 ways to speed up a slow Python script. '
'EXCLUDE:\n'
'- Suggestions requiring third-party libraries (stdlib only)\n'
'- Suggestions about hardware upgrades\n'
'- Rewrites of the entire script\n'
'- Suggestions that take more than 30 minutes to implement\n'
'Each suggestion: one sentence describing what to do, one sentence on expected speedup.'
)
}]
)
print(response.choices[0].message.content)Tout rassembler
Construisons une consigne entièrement concrète, étape par étape. En partant de : « Rédigez une description de poste. »
- Ajoutez le poste : « Pour un ingénieur senior en apprentissage automatique »
- Ajoutez une entité nommée : « dans une start-up d’IA de série B à Londres »
- Ajoutez le nombre de mots : « 350 à 400 mots »
- Ajoutez l’audience : « pour des candidats ayant au moins 5 ans d’expérience »
- Ajoutez la structure : « Format : introduction, responsabilités (8 puces), exigences (5 puces), atouts appréciés (3 puces) »
- Ajoutez une exclusion : « Pas de clichés comme “au rythme effréné” ou “passionné” »
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
concrete_prompt = (
'Write a job description for a Senior ML Engineer position '
'at a Series B AI startup in London. '
'Target candidate: 5+ years ML experience, strong Python, familiar with LLMs. '
'Length: 350-400 words. '
'Structure:\n'
'1. 3-sentence company intro (no fluff — focus on product and mission)\n'
'2. Responsibilities: exactly 8 bullet points\n'
'3. Requirements: exactly 5 bullet points\n'
'4. Nice-to-haves: exactly 3 bullet points\n'
'EXCLUDE: phrases like "fast-paced", "passionate", "ninja", "rockstar", "self-starter".'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=600,
messages=[{'role': 'user', 'content': concrete_prompt}]
)
print(response.content[0].text)L’habitude d’enrichir les prompts
Développez l’habitude d’enrichir chaque consigne avant de l’envoyer. Passez rapidement en revue ces questions d’enrichissement mental :
- Puis-je remplacer un mot vague par un nombre ?
- Puis-je citer un outil, une technologie ou une personne précise ?
- Puis-je décrire l’audience avec davantage de précision ?
- Puis-je ajouter un exemple de ce que je veux ?
- Puis-je ajouter au moins une contrainte indiquant de ne pas inclure quelque chose ?
- Puis-je préciser davantage le format du résultat ?
Même deux ou trois enrichissements améliorent considérablement la qualité du résultat.
# Prompt enrichment in code form: before/after comparison
before = 'Give me ideas for my presentation.'
after = (
'Generate 6 opening hook ideas for a 15-minute conference talk '
'titled "Why Your AI Prompts Are Failing You" at PyCon 2025. '
'Audience: Python developers, mostly backend, some ML experience. '
'Each hook: 2 sentences max. '
'Mix: 2 provocative statistics, 2 counterintuitive questions, 2 short stories. '
'EXCLUDE: "Did you know..." openers and rhetorical questions about the future of AI.'
)
print('BEFORE:', before)
print()
print('AFTER:', after)Vérification des connaissances
Un fondateur de start-up envoie la consigne suivante : « Aidez-moi à rédiger un texte promotionnel. » Quelle version révisée utilise les détails concrets les plus efficaces ?
Ajout de détails concrets — Récapitulatif
Les détails concrets transforment des consignes vagues en instructions précises. Utilisez ces techniques d’ancrage :
- Nombre de mots : remplacez « court/long » par des nombres exacts
- Entités nommées : produits, outils, entreprises et personnes précis
- Audience : rôle, niveau d’expérience et connaissances existantes
- Contraintes quantitatives : exactement N éléments, N % de chaque type
- Vocabulaire du domaine : utilisez les termes propres au domaine pour signaler la profondeur attendue
- Exemples : montrez à quoi ressemble un bon résultat
- Exclusions : indiquez ce que le modèle doit éviter
Questions Fréquemment Posées
La leçon « Ajouter des détails concrets » est-elle gratuite ?
Oui — le texte complet de « Ajouter des détails concrets » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours AI Prompt Engineering, passe à CoddyKit PRO. Le cours AI Prompt Engineering comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Ajouter des détails concrets » ?
Nombres, noms, formats et exemples qui structurent les résultats de l’IA. Tu pratiques AI Prompt Engineering avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer AI Prompt Engineering ?
Aucune expérience préalable n'est requise. AI Prompt Engineering sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.
Combien de temps prend la leçon « Ajouter des détails concrets » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon AI Prompt Engineering ?
Oui. Chaque leçon AI Prompt Engineering inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Pourquoi la précision est importante
- Éliminer l’ambiguïté des invites
- Ajouter des détails concrets
- Comparer les invites vagues et précises