Aller au contenu principal

Exercice : ingénierie de prompts

Mis à jour le 30 juillet 2026

Objectif

Améliorer un générateur de descriptions produit en appliquant les 4 techniques d’ingénierie de prompts, une par une. À chaque étape, vous observez l’amélioration qualitative.

Les 3 produits de test

Vous testerez chaque version du prompt sur ces 3 produits :

products = [
    {
        "name": "SoundWave Pro X",
        "type": "Casque audio sans fil",
        "price": "179 EUR",
        "features": "Reduction de bruit active, 40h d'autonomie, Bluetooth 5.3, pliable, microphones integres, codec LDAC",
        "target": "Professionnels en télétravail et audiophiles",
        "brand_tone": "Premium mais accessible"
    },
    {
        "name": "BrewMaster 3000",
        "type": "Machine a cafe automatique",
        "price": "449 EUR",
        "features": "Broyeur ceramique, 15 boissons, ecran tactile, reservoir 1.8L, systeme lait integre, mode eco",
        "target": "Amateurs de café exigeants",
        "brand_tone": "Expert et passionnee"
    },
    {
        "name": "TrailBlazer 45L",
        "type": "Sac a dos de randonnee",
        "price": "129 EUR",
        "features": "45 litres, dos ventile, housse de pluie integree, poches laterales filet, sangles de compression, compatible poche a eau",
        "target": "Randonneurs reguliers (treks 2-5 jours)",
        "brand_tone": "Aventurier et fiable"
    }
]

Itération 1 : Le prompt naïf (baseline)

import anthropic

client = anthropic.Anthropic()
MODEL = "claude-sonnet-5"

def generate_description(prompt: str, product: dict) -> str:
    """Génère une description produit avec le prompt donne."""
    formatted = prompt.format(**product)
    response = client.messages.create(
        model=MODEL,
        max_tokens=1024,
        messages=[{"role": "user", "content": formatted}]
    )
    return response.content[0].text

# V1 — Prompt naif
PROMPT_V1 = "Écris une description produit pour {name}."

for p in products:
    print(f"\n--- {p['name']} ---")
    print(generate_description(PROMPT_V1, p))

Problèmes attendus : descriptions génériques, longueur imprécise, pas de structure, ton aléatoire, les caractéristiques du produit ne sont pas exploitées.

Itération 2 : Être clair et direct

On reecrit la première ligne avec un verbe d’action précis et on indique l’objectif.

# V2 — Clair et direct
PROMPT_V2 = """Redige une description commerciale pour le produit {name} ({type}).
La description doit convaincre un client potentiel d'acheter ce produit a {price}.
Cible : {target}."""

for p in products:
    print(f"\n--- {p['name']} ---")
    print(generate_description(PROMPT_V2, p))

Améliorations attendues : la description est orientée vers la vente, le prix et la cible sont pris en compte. Mais la longueur, la structure et le ton restent imprécis.

Itération 3 : Être spécifique

On ajoute des consignes sur la sortie (longueur, structure, contenu obligatoire) et le ton éditorial.

# V3 — Specifique
PROMPT_V3 = """Redige une description commerciale pour le produit {name} ({type}) au prix de {price}.

Consignes :
- Longueur : 150-200 mots
- Structure : accroche (1 phrase percutante) + 1 paragraphe sur les benefices + liste de 3-4 fonctionnalites cles + phrase de conclusion avec appel a l'action
- Ton : {brand_tone}
- Cible : {target}
- Mentionne au moins 3 fonctionnalites parmi : {features}
- Mets en avant les benefices pour l'utilisateur, pas juste les specs techniques
- Ne commence pas par "Decouvrez" ou "Presentant"
"""

for p in products:
    print(f"\n--- {p['name']} ---")
    print(generate_description(PROMPT_V3, p))

Améliorations attendues : structure cohérente, bonne longueur, ton adapté. La description est vendable. Mais le format peut encore varier.

Itération 4 : Structurer avec des balises XML

On encadre les informations produit dans des balises XML pour séparer clairement les données des instructions.

# V4 — Balises XML
PROMPT_V4 = """<instructions>
Redige une description commerciale pour le produit ci-dessous.
Longueur : 150-200 mots.
Structure : accroche (1 phrase percutante) + paragraphe benefices + liste de 3-4 fonctionnalites + appel a l'action.
Ne commence pas par "Decouvrez" ou "Presentant".
Mets en avant les benefices pour l'utilisateur, pas juste les specs.
</instructions>

<produit>
Nom : {name}
Type : {type}
Prix : {price}
Fonctionnalites : {features}
</produit>

<cible>
Public : {target}
Ton editorial : {brand_tone}
</cible>"""

for p in products:
    print(f"\n--- {p['name']} ---")
    print(generate_description(PROMPT_V4, p))

Améliorations attendues : meilleure séparation entre instructions et données. Claude distingue clairement ce qu’il doit faire de ce sur quoi il doit travailler.

Itération 5 : Fournir un exemple

On ajoute un exemple de description idéale pour ancrer le format et le style.

# V5 — Avec exemple
PROMPT_V5 = """<instructions>
Redige une description commerciale pour le produit ci-dessous.
Longueur : 150-200 mots.
Structure : accroche (1 phrase percutante) + paragraphe benefices + liste de 3-4 fonctionnalites + appel a l'action.
Ne commence pas par "Decouvrez" ou "Presentant".
Mets en avant les benefices pour l'utilisateur, pas juste les specs.
</instructions>

<exemple>
  <sample_input>
  Nom : AeroLite Runner
  Type : Chaussure de running
  Prix : 139 EUR
  Fonctionnalites : Semelle carbone, 195g, mesh respirant, drop 6mm, amorti reactif
  Public : Coureurs reguliers (10-50 km/semaine)
  Ton : Dynamique et technique
  </sample_input>
  <ideal_output>
  Chaque kilometre compte. L'AeroLite Runner est concue pour les coureurs qui refusent de choisir entre performance et confort.

  Avec seulement 195 grammes au pied, vous oubliez vos chaussures pour ne penser qu'a votre foulée. La semelle carbone transforme chaque appui en propulsion, tandis que le mesh respirant garde vos pieds au sec même apres une heure d'effort.

  - **Semelle carbone** : restitution d'energie maximale a chaque foulee
  - **195g seulement** : l'une des plus legeres de sa categorie
  - **Amorti reactif** : protection articulaire sans sacrifier la reactivite
  - **Drop 6mm** : equilibre naturel entre attaque talon et mediopied

  A 139 EUR, l'AeroLite Runner est votre prochain PR qui n'attend plus que vous.
  </ideal_output>
</exemple>

<produit>
Nom : {name}
Type : {type}
Prix : {price}
Fonctionnalites : {features}
</produit>

<cible>
Public : {target}
Ton editorial : {brand_tone}
</cible>"""

for p in products:
    print(f"\n--- {p['name']} ---")
    print(generate_description(PROMPT_V5, p))

Améliorations attendues : le format, le style et la structure sont constants d’un produit à l’autre. L’accroche est percutante, les fonctionnalités sont orientées bénéfices, l’appel à l’action est naturel.

Solution complète

"""
Exercice d'ingenierie de prompts : generateur de descriptions produit.
Necessite : pip install anthropic
Variable d'environnement : ANTHROPIC_API_KEY
"""

import anthropic

client = anthropic.Anthropic()
MODEL = "claude-sonnet-5"

products = [
    {
        "name": "SoundWave Pro X",
        "type": "Casque audio sans fil",
        "price": "179 EUR",
        "features": "Reduction de bruit active, 40h d'autonomie, Bluetooth 5.3, pliable, microphones integres, codec LDAC",
        "target": "Professionnels en télétravail et audiophiles",
        "brand_tone": "Premium mais accessible"
    },
    {
        "name": "BrewMaster 3000",
        "type": "Machine a cafe automatique",
        "price": "449 EUR",
        "features": "Broyeur ceramique, 15 boissons, ecran tactile, reservoir 1.8L, systeme lait integre, mode eco",
        "target": "Amateurs de café exigeants",
        "brand_tone": "Expert et passionnee"
    },
    {
        "name": "TrailBlazer 45L",
        "type": "Sac a dos de randonnee",
        "price": "129 EUR",
        "features": "45 litres, dos ventile, housse de pluie integree, poches laterales filet, sangles de compression, compatible poche a eau",
        "target": "Randonneurs reguliers (treks 2-5 jours)",
        "brand_tone": "Aventurier et fiable"
    }
]

def generate_description(prompt: str, product: dict) -> str:
    formatted = prompt.format(**product)
    response = client.messages.create(
        model=MODEL,
        max_tokens=1024,
        messages=[{"role": "user", "content": formatted}]
    )
    return response.content[0].text

# --- Les 5 versions du prompt ---

PROMPT_V1 = "Écris une description produit pour {name}."

PROMPT_V2 = """Redige une description commerciale pour le produit {name} ({type}).
La description doit convaincre un client potentiel d'acheter ce produit a {price}.
Cible : {target}."""

PROMPT_V3 = """Redige une description commerciale pour le produit {name} ({type}) au prix de {price}.

Consignes :
- Longueur : 150-200 mots
- Structure : accroche + paragraphe benefices + liste 3-4 fonctionnalites + appel a l'action
- Ton : {brand_tone}
- Cible : {target}
- Mentionne au moins 3 fonctionnalites parmi : {features}
- Benefices utilisateur, pas juste specs techniques
- Ne commence pas par "Decouvrez"
"""

PROMPT_V4 = """<instructions>
Redige une description commerciale pour le produit ci-dessous.
Longueur : 150-200 mots.
Structure : accroche + paragraphe benefices + liste 3-4 fonctionnalites + appel a l'action.
Ne commence pas par "Decouvrez" ou "Presentant".
Mets en avant les benefices utilisateur.
</instructions>

<produit>
Nom : {name}
Type : {type}
Prix : {price}
Fonctionnalites : {features}
</produit>

<cible>
Public : {target}
Ton editorial : {brand_tone}
</cible>"""

PROMPT_V5 = """<instructions>
Redige une description commerciale pour le produit ci-dessous.
Longueur : 150-200 mots.
Structure : accroche + paragraphe benefices + liste 3-4 fonctionnalites + appel a l'action.
Ne commence pas par "Decouvrez" ou "Presentant".
Mets en avant les benefices utilisateur.
</instructions>

<exemple>
  <sample_input>
  Nom : AeroLite Runner | Type : Chaussure de running | Prix : 139 EUR
  Fonctionnalites : Semelle carbone, 195g, mesh respirant, drop 6mm, amorti reactif
  Public : Coureurs reguliers | Ton : Dynamique et technique
  </sample_input>
  <ideal_output>
  Chaque kilometre compte. L'AeroLite Runner est concue pour les coureurs qui refusent de choisir entre performance et confort.

  Avec seulement 195 grammes au pied, vous oubliez vos chaussures pour ne penser qu'a votre foulée. La semelle carbone transforme chaque appui en propulsion, tandis que le mesh respirant garde vos pieds au sec même apres une heure d'effort.

  - **Semelle carbone** : restitution d'energie maximale a chaque foulee
  - **195g seulement** : l'une des plus legeres de sa categorie
  - **Amorti reactif** : protection articulaire sans sacrifier la reactivite
  - **Drop 6mm** : equilibre naturel entre attaque talon et mediopied

  A 139 EUR, l'AeroLite Runner est votre prochain PR qui n'attend plus que vous.
  </ideal_output>
</exemple>

<produit>
Nom : {name}
Type : {type}
Prix : {price}
Fonctionnalites : {features}
</produit>

<cible>
Public : {target}
Ton editorial : {brand_tone}
</cible>"""

# --- Execution ---
prompts = {
    "V1 (naif)": PROMPT_V1,
    "V2 (clair et direct)": PROMPT_V2,
    "V3 (specifique)": PROMPT_V3,
    "V4 (balises XML)": PROMPT_V4,
    "V5 (avec exemple)": PROMPT_V5,
}

for version, prompt in prompts.items():
    print(f"\n{'='*60}")
    print(f"  {version}")
    print(f"{'='*60}")
    for p in products:
        print(f"\n--- {p['name']} ---")
        print(generate_description(prompt, p))

Ce que vous apprenez

  • Chaque technique apporte une amélioration incrémentale et mesurable
  • Clair et direct fixe l’intention générale
  • Spécifique donne les contraintes concrètes
  • XML structure les données quand le prompt grossit
  • Exemples ancrent le format et le style de manière définitive
  • L’ordre d’application compte : partez toujours du général vers le spécifique
← Lecon precedenteFournir des exemplesLecon suivante →Testez vos connaissances : ingénierie de prompts