Atelier

Lesson 7 — Prompts pour l'entreprise

Gabarits, variables et versionnage

30min

This content is not translated yet. Showing the original version.

Du prompt collé au gabarit

flowchart LR
  A["Prompt copié-collé dans 5 scripts"] --> B["Un fichier par prompt"]
  B --> C["Variables nommées : client, commande, politique"]
  C --> D["Version dans le fichier et dans git"]
  D --> E["Version enregistrée avec chaque réponse"]
AvantAprès
Le même prompt copié dans le bot WhatsApp, le script de mails et un notebook, avec trois variantes divergentesUn fichier prompts/reponse_retard.txt, chargé par les trois outils
"Réponds à " + nom + " au sujet de " + commande construit à la mainGabarit avec $prenom, $numero_commande, remplis par string.Template
« Qui a modifié le prompt mardi ? » Personne ne saitgit log prompts/reponse_retard.txt
Une réponse étrange en production, impossible de savoir avec quel promptChaque réponse loggée avec prompt_id et version

Des variables, avec la bibliothèque standard

string.Template suffit : ses $variables ne se confondent pas avec les accolades d'un JSON présent dans le prompt (contrairement à str.format).

prompts/reponse_retard.txt
# id: reponse_retard
# version: 1.2.0
# description: Réponse à un client dont la commande est en retard.
Tu es conseiller du service client de $entreprise.
<commande>Numéro $numero_commande, date de livraison prévue : $date_prevue.</commande>
<message_client>$message</message_client>
Réponds en 3 phrases maximum, vouvoiement, en $langue.
Format : {"reponse": "...", "escalade": true|false}
gabarits.py
from pathlib import Path
from string import Template

def charger(nom: str) -> tuple[dict, Template]:
    lignes = Path(f"prompts/{nom}.txt").read_text(encoding="utf-8").splitlines()
    meta = {l[2:].split(":")[0]: l.split(":", 1)[1].strip() for l in lignes if l.startswith("# ")}
    corps = "\n".join(l for l in lignes if not l.startswith("# "))
    return meta, Template(corps)

meta, gabarit = charger("reponse_retard")
prompt = gabarit.substitute(entreprise="Vélos du Sud", numero_commande="A-1029",
                            date_prevue="12 octobre", message="Toujours rien reçu !", langue="français")
print(meta["version"])  # 1.2.0

Pourquoi préférer string.Template à str.format pour un prompt qui contient un exemple JSON ?

Versionner ses prompts

Un prompt est du code qui s'exprime en français : il se versionne de la même façon.

ChangementExempleVersion
Correction mineure (faute, reformulation sans effet attendu)Faute de frappe1.2.0 → 1.2.1
Nouveau comportement compatibleAjout de la langue arabe1.2.1 → 1.3.0
Changement qui casse le format de sortieNouveau champ JSON obligatoire1.3.0 → 2.0.0

Règles simples :

  1. Un fichier par prompt, dans un dossier prompts/ du dépôt.
  2. Une modification = un commit avec un message qui dit pourquoi (« ajoute l'escalade allergie suite au ticket 88 »).
  3. Loggez id et version avec chaque appel, ainsi que le nom du modèle : la même version de prompt peut se comporter différemment sur un autre modèle.
  4. Pas de modification directe en production : on passe par les tests (leçon suivante).

Que faut-il enregistrer avec chaque réponse produite en production ? (plusieurs réponses)

Exercice

Transformez ce prompt écrit en dur dans un script en gabarit versionné, avec ses métadonnées et ses variables :

prompt = "Écris une relance pour Mme Martin qui n'a pas payé la facture F-778 de 340 euros échue le 1er octobre. Ton courtois."
Voir la solution
prompts/relance_facture.txt
# id: relance_facture
# version: 1.0.0
# description: Première relance courtoise d'une facture impayée.
Tu es chargé de recouvrement chez $entreprise. Ton courtois, jamais menaçant.
<facture>Client : $civilite $nom. Facture $numero de $montant, échue le $echeance.</facture>
Rédige un mail de relance de 80 mots maximum : rappelle la facture, propose de contacter
le service comptable en cas d'erreur, termine par « Bien cordialement ».
meta, g = charger("relance_facture")
prompt = g.substitute(entreprise="Atelier Bois", civilite="Mme", nom="Martin",
                      numero="F-778", montant="340 EUR", echeance="1er octobre")

Les données personnelles (nom, montant) restent hors du fichier versionné : elles ne sont injectées qu'au moment de l'appel.

Je sais faire

  • Ranger un prompt dans un fichier avec id, version et description.
  • Remplir un gabarit avec string.Template et détecter une variable manquante.
  • Choisir le bon numéro de version selon le type de changement.
  • Logger prompt, version et modèle avec chaque réponse.
Next