Ecrire un prompt agent
Comment construire un prompt agent. Structure obligatoire, chaque bloc, calibrer l'autonomie, tester, erreurs courantes.
Ecrire un prompt agent
Le prompt est le cerveau de l'agent. Mauvais prompt = agent imprevistible.
Un bon prompt agent n'est pas un texte libre. C'est une structure rigide avec 7 blocs obligatoires.
La structure obligatoire
Chaque prompt agent contient ces 7 blocs. Dans cet ordre.
[1. IDENTITE ET ROLE]
[2. PERSONA]
[3. SOURCES ET ACCES]
[4. REGLES DE COMPORTEMENT]
[5. FORMAT DES OUTPUTS]
[6. REGLES D'ESCALADE]
[7. REGLES D'APPRENTISSAGE]Aucun bloc n'est optionnel. Un bloc vide vaut mieux qu'un bloc absent.
Bloc 1 : Identite et role
Dit QUI est l'agent et CE QU'IL FAIT.
## Identite
Tu es le Content Manager d'Agent OS.
Tu geres la creation et la publication de contenu.
## Perimetre
- Redaction d'articles de blog
- Publication sur les reseaux sociaux
- Suivi des metriques de contenu
## Hors perimetre
- Strategie marketing globale
- Gestion du budget publicitaire
- Relations presseRegle : le hors-perimetre est aussi important que le perimetre.
Bloc 2 : Persona
Comment l'agent SE COMPORTE. Son style.
## Persona
- Ton : professionnel, direct, sans jargon inutile.
- Longueur : phrases courtes. Max 20 mots.
- Attitude : proactif. Propose des solutions, pas des problemes.
- Langue : francais. Pas d'anglicismes sauf termes techniques.Sans persona, l'agent utilise un ton generique. Avec, il est reconnaissable.
Bloc 3 : Sources et acces
Les outils et donnees AUTORISES.
## Sources
- MCP obsidian : lecture/ecriture KB
- MCP notion : lecture CRM client
- MCP email : envoi uniquement (pas de lecture)
## Donnees accessibles
- /projects/content/ — tous les fichiers
- /knowledge/marketing/ — en lecture seule
## Donnees interdites
- /projects/finance/ — aucun acces
- Vault secrets — aucun acces directPrincipe du moindre privilege. L'agent n'a que ce dont il a besoin.
Bloc 4 : Regles de comportement
Les DO et DON'T explicites.
## Regles
- TOUJOURS verifier l'orthographe avant de publier.
- TOUJOURS inclure un CTA dans chaque article.
- JAMAIS publier sans validation du manager.
- JAMAIS utiliser de contenu copie sans attribution.
- Si le brief est ambigu, demander une clarification.
- Si une metrique baisse de > 20%, alerter le manager.Etre exhaustif. Chaque regle non ecrite sera interpretee librement.
Bloc 5 : Format des outputs
Comment l'agent REND ses resultats.
## Format output
### Pour un article
- Titre (max 60 caracteres)
- Meta description (max 155 caracteres)
- Corps (500-1500 mots)
- 3 tags suggeres
### Pour un rapport
- Resume executif (3 lignes)
- Metriques cles (tableau)
- Recommandations (liste numerotee)
- Prochaine actionSans format defini, chaque output est different. Impossible a automatiser.
Bloc 6 : Regles d'escalade
QUAND l'agent doit arreter et remonter.
## Escalade vers manager
- Brief incomplet ou contradictoire
- Besoin d'acces a une source non autorisee
- Resultat incertain (confiance < 70%)
- Tache hors perimetre detectee
## Escalade vers CEO
- Conflit avec un autre agent/manager
- Decision impactant la reputation
- Budget depasse ou non prevu
- Erreur critique detectee post-publicationUn agent sans regles d'escalade est dangereux. Il prend des decisions qu'il ne devrait pas prendre.
Bloc 7 : Regles d'apprentissage
Comment l'agent S'AMELIORE.
## Apprentissage
- Apres chaque publication : noter les metriques dans le log.
- Si un article performe > 2x la moyenne : analyser pourquoi.
- Si un article performe < 0.5x : analyser pourquoi.
- Mettre a jour le skill-contenu avec les lecons apprises.
- Revue mensuelle des patterns de succes/echec.Calibrer l'autonomie
Tous les agents n'ont pas le meme niveau de liberte.
+-------------+---------------------------+------------------------+
| Niveau | L'agent decide... | Modele conseille |
+-------------+---------------------------+------------------------+
| Executant | Rien. Il suit les procs. | Haiku ($) |
| Autonome | Comment executer la tache | Sonnet ($$$) |
| Strategique | Quelles taches prioriser | Opus ($$$$) |
+-------------+---------------------------+------------------------+Haiku ($) — Executant
Utiliser quand :
- La tache est repetitive
- Les etapes sont 100% definies
- Aucune decision n'est necessaire
Exemple : "Reformate ce CSV selon le template T-003."Sonnet ($$$) — Autonome
Utiliser quand :
- La tache necessite du raisonnement
- Plusieurs approches sont possibles
- Le contexte influence la methode
Exemple : "Redige un article sur le sujet X pour notre audience."Opus ($$$$) — Strategique
Utiliser quand :
- La decision a un impact significatif
- Plusieurs facteurs contradictoires
- Erreur = consequence grave
Exemple : "Decide si on lance le produit Y ce trimestre."Format prompt sub-agent
Les sub-agents recoivent un prompt simplifie en 4 parties.
QUOI : [La tache precise]
CONTEXTE : [Ce que le sub-agent doit savoir]
COMMENT : [Les contraintes et la methode]
FORMAT : [Comment rendre le resultat]Exemple concret :
QUOI : Resumer cet article en 3 bullet points.
CONTEXTE : Article de blog tech, audience = developpeurs juniors.
COMMENT : Phrases simples. Pas de jargon. Max 15 mots par point.
FORMAT : Liste markdown. Chaque point commence par un emoji.Regle dure : profondeur max = 1. Pas de sub-sub-agents.
Tester un prompt
Test en 3 rounds
Round 1 : Tache simple
→ Le prompt produit-il le format attendu ?
Round 2 : Tache ambigue
→ L'agent escalade-t-il au lieu de deviner ?
Round 3 : Tache hors perimetre
→ L'agent refuse-t-il ou signale-t-il ?Si les 3 rounds passent, le prompt est valide.
Erreurs courantes
Prompt trop long. 2000 mots de prompt = l'agent oublie la moitie. Les 7 blocs doivent tenir en 80 lignes max.
Pas de hors-perimetre. L'agent fait tout ce qu'on lui demande. Y compris ce qu'il ne devrait pas faire.
Regles implicites. "C'est evident qu'il ne doit pas faire ca." Non. Rien n'est evident pour un agent. Tout est explicite.
Format output manquant. Chaque agent invente son propre format. Le manager perd du temps a reformater.
Pas de test hors-perimetre. L'agent semble marcher. Jusqu'au jour ou il recoit une tache inattendue.