Une TVA venue d'ailleurs
Sophie gère le site d'une petite boutique de thé à Bordeaux. Elle écrit à un assistant : « Fais-moi une fonction pour la TVA. » Le code arrive vite. Il applique un taux de 19 % et ne sait pas si le prix donné est HT ou TTC.
L'assistant n'a pas mal travaillé. Il a comblé les trous de la demande au hasard.
À la fin de cette leçon
Remarque
Je peux rédiger une demande claire, avec du contexte et un exemple.
Mots clés
| Mot | Ce que ça veut dire | Exemple |
|---|---|---|
| Demande | le texte que vous envoyez à l'assistant | |
| Tâche | ce que vous voulez obtenir | |
| Contexte | les faits utiles sur votre situation | |
| Contrainte | une règle que la réponse doit respecter | |
| Exemple | une entrée et la sortie attendue | prix_ttc(10) renvoie 12.0 |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Une bonne demande a quatre parties
Une demande claire dit d'abord la tâche : la fonction ou le texte que vous voulez. Elle donne ensuite le contexte : le langage, les données, le métier.
Elle pose les contraintes : arrondi, bibliothèques permises, format de sortie. Enfin, elle montre un exemple : une entrée et le résultat attendu. Chaque partie retire une décision que l'assistant aurait prise à votre place.
Exemple : la même demande, en mieux
| Partie | Demande floue | Demande claire |
|---|---|---|
| Tâche | Une fonction pour la TVA | Une fonction prix_ttc(prix_ht) en Python |
| Contexte | Rien | Boutique en ligne, TVA à 20 %, euros |
| Contrainte | Rien | Arrondir au centime, sans bibliothèque |
| Exemple | Rien | prix_ttc(10) renvoie 12.0 |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
À vous : assembler une demande
# On assemble une demande en quatre parties.
tache = "Tâche : écris une fonction Python prix_ttc(prix_ht)."
contexte = "Contexte : boutique en ligne, TVA à 20 %, prix en euros."
exemple = "Exemple : prix_ttc(10) renvoie 12.0"
demande = tache + "\n" + contexte + "\n" + exemple
print(demande)
# Il manque la contrainte. Ajoutez une variable contrainte :
# "Contrainte : arrondir au centime, sans bibliothèque."
# Ajoutez-la à la demande, puis relancez.
Un exemple vaut mieux qu'une longue phrase
Décrire un format en mots est difficile. Le montrer est simple. Écrivez une entrée réelle et la sortie exacte que vous attendez.
Pour une date, donnez « 2026-03-05 » et attendez « 05/03/2026 ». Pour un montant, donnez 1234.5 et attendez « 1 234,50 € ». Ajoutez un cas difficile si vous en connaissez un, comme un panier vide.
Une erreur fréquente
Attention
Beaucoup pensent qu'une demande longue est une bonne demande. Ce qui compte, ce sont les faits utiles : la tâche, le contexte, les contraintes, un exemple. Trois lignes précises valent mieux qu'une page de politesses.