Guide opérateur · Mission et preuve
12 min de lecture
Mis à jour le
Bien briefer et vérifier un agent
Un chemin pour opérateur non développeur : comment expliquer ma demande à un agent, empêcher mon agent de modifier sans demander, et vérifier le travail de mon agent.
Réponse directe
Pour bien briefer un agent, commence par le résultat que tu pourras constater et par la définition de done, puis fournis le contexte et les documents utiles, et fixe les contraintes et les non-objectifs. Distingue lire ou analyser (observation), modifier, envoyer ou dépenser (modification externe), et l’approbation humaine avant une action coûteuse, publique ou destructive. Demande une preuve dans un format déclaré, pas un paragraphe confiant. Ensuite, vérifie le travail de mon agent, corrige, puis relance seulement l’étape bornée qui a échoué. Ce guide montre comment expliquer ma demande à un agent et comment empêcher mon agent de modifier sans demander.
Glossary
Termes expliqués ici
Ouvre un terme pour lire sa définition courte, puis poursuis vers sa fiche sourcée si nécessaire.
01
Décris le résultat observable et la définition de done
Si tu te demandes comment expliquer ma demande à un agent, commence par ce que tu pourras constater sans rien changer. Une mission vague (« améliore ce dossier ») n’a pas d’état de fin. Une mission brieffée dit l’état visible attendu : trois dates de livraison dans le tableau, un brouillon non envoyé, un résumé de deux pages. C’est une observation : tu lis, tu comptes, tu compares à la définition de done.
Ne confonds pas cet état avec une action. « Le tableau contient trois dates » est une observation. « Envoie le tableau au client » est une modification externe. « J’autorise l’envoi après lecture » est une approbation humaine. La définition de done ne doit contenir que ce que tu peux vérifier en regardant le résultat, pas ce que l’agent a le droit de pousser dans le monde.
- Observation : le tableau affiche trois dates de livraison identiques au devis.
- Modification externe : l’agent écrit dans le tableur ou envoie un message.
- Approbation humaine : tu autorises l’écriture ou l’envoi après avoir vu le tableau.
- Done : un état que tu peux constater sans relancer d’action.
La définition de done est une observation. Si tu ne peux pas la constater sans écrire, envoyer ou dépenser, elle n’est pas encore une définition de done.
02
Fournis le contexte et les documents utiles
L’agent ne voit que ce que tu lui donnes. Joins le devis, le tableur, le fil de messages, la décision déjà prise. Dis ce qui est la source à lire et ce qui n’est qu’un exemple. Un document joint pour être lu reste une observation ; un document joint « pour le mettre à jour » ouvre une modification externe.
Borne aussi l’usage. « Lis le PDF du 12 mars et le tableur v3 » est une observation. « Corrige le tableur v3 » est une modification externe, à n’autoriser que si tu l’as écrite à part. « N’écris dans le tableur qu’après mon accord » est une approbation humaine. Sans cette séparation, un contexte utile devient une permission trop large.
- Observation : lis le devis PDF et le tableur v3, sans y écrire.
- Modification externe : toute écriture dans le tableur, tout envoi, tout paiement.
- Approbation humaine : tu décides après avoir vu ce que la lecture a produit.
- Dis quels documents sont à jour, lesquels sont des brouillons, lesquels sont hors sujet.
03
Fixe les contraintes et les non-objectifs
Une contrainte dit ce qui ne doit pas bouger. Un non-objectif dit ce que tu ne demandes pas cette fois. Sans les écrire, l’agent comble le vide par une initiative. « Ne change pas le tarif » est une contrainte sur une modification externe. « Le tarif actuel est de 40 € ; constate-le seulement » est une observation. « Tout changement de tarif attend ma décision » est une approbation humaine.
Les non-objectifs évitent le travail hors sujet : pas de refonte du modèle, pas de message aux clients, pas de nouveau dossier. Ils ne sont pas des résultats à constater ; ce sont des interdictions. Si une contrainte et un non-objectif se contredisent, corrige-les avant de lancer la mission, sinon l’agent devra choisir à ta place.
- Observation : constate le tarif, le destinataire, ou l’état actuel, sans le changer.
- Modification externe : changer un tarif, créer un dossier, publier une page.
- Approbation humaine : tu lèves une contrainte par une décision datée, pas l’agent.
- Écris ce qui est hors périmètre aussi clairement que ce qui est dans la mission.
Les contraintes et non-objectifs bornent l’autonomie. Ils se lisent avant toute action, pas après un dégât.
04
Distingue lire ou analyser, puis modifier, envoyer ou dépenser
Quatre verbes, deux familles. Lire et analyser sont des observations : l’agent inspecte, compare, résume, et te rend un état. Modifier, envoyer et dépenser sont des modifications externes : un fichier change, un message part, de l’argent sort. Le geste utile pour empêcher mon agent de modifier sans demander est d’écrire cette frontière avant le premier outil.
Un résumé annoté reste une observation tant qu’il n’est pas collé dans un logiciel externe. Un brouillon dans la conversation n’est pas un envoi. Un devis calculé n’est pas un paiement. Si tu as besoin d’une action réelle, nomme-la, nomme la cible, et bloque-la derrière une approbation. Sans ça, « analyse ce dossier » se transforme trop facilement en « j’ai déjà écrit au client ».
- Observation : lire, extraire, comparer, résumer, lister les écarts.
- Modification externe : modifier un fichier, envoyer un message, publier, payer, supprimer.
- Approbation humaine : tu autorises une cible résolue, pas une famille d’actions.
- Sans demande explicite, l’agent ne modifie pas, n’envoie pas, et ne dépense pas.
05
Fixe les approbations humaines et le format de preuve
Toute action coûteuse, publique ou destructive attend ton accord. L’approbation n’est pas une observation (« le brouillon est prêt ») et n’est pas une modification (« le message est parti »). C’est ta décision, datée, sur une cible précise : ce destinataire, ce fichier, ce montant. Un « tu peux y aller » trop large n’est pas une approbation ; c’est une autonomie déguisée.
Le format de preuve dit comment tu sauras que c’est fait, sans te fier à un paragraphe confiant. « Capture du tableau avec les trois dates » est une observation. « Aucun envoi n’a eu lieu » est le compte rendu d’une modification externe absente. « Aucune action bloquée n’a été faite sans mon accord » est le compte rendu d’une approbation respectée. Si la preuve n’est pas déclarée, tu ne pourras pas vérifier le travail de mon agent.
- Observation : une capture, un extrait, un compte, un fichier avant/après que tu peux lire.
- Modification externe : le journal de ce qui a réellement été écrit, envoyé, payé ou détruit.
- Approbation humaine : la décision, la cible, et le moment où tu as dit oui ou non.
- Un paragraphe confiant n’est pas une preuve ; le format de preuve l’est.
L’approbation précède l’action coûteuse, publique ou destructive. La preuve précède le « c’est bon ».
06
Vérifie le résultat, corrige, puis relance seulement l’étape bornée
Vérifier le travail de mon agent, ce n’est pas relire un résumé fluide. C’est comparer la preuve au format déclaré et à la définition de done. Si les trois dates sont dans le tableau, l’observation est bonne. Si l’agent a aussi envoyé le tableau, une modification externe a dépassé la mission. Si cet envoi n’avait pas ton accord, l’approbation humaine a été sautée. Ces trois constats se notent séparément.
Quand quelque chose cloche, ne relance pas toute la mission. Isole l’étape en échec, décris la correction comme une nouvelle modification externe bornée, et redemande une approbation si l’étape touche encore une action coûteuse, publique ou destructive. Relancer « depuis le début » multiplie les effets de bord. Relancer l’étape bornée te rend le contrôle.
- Observation : la preuve correspond-elle au format et à la définition de done ?
- Modification externe : qu’est-ce qui a réellement changé, été envoyé, payé ou détruit ?
- Approbation humaine : chaque action bloquée a-t-elle attendu ton accord ?
- Correction : une nouvelle étape bornée, pas une mission entière rejouée.
À conserver
Checklist avant de lancer, puis après le résultat
- 01J’ai écrit le résultat observable et la définition de done.
- 02J’ai joint le contexte utile et dit quels documents se lisent sans être modifiés.
- 03J’ai fixé les contraintes et les non-objectifs.
- 04J’ai séparé lecture et analyse d’un côté, modification, envoi et dépense de l’autre.
- 05J’ai listé les actions qui attendent mon approbation, surtout si elles sont coûteuses, publiques ou destructives.
- 06J’ai déclaré le format de preuve, pas un paragraphe confiant.
- 07Après coup, je peux vérifier le travail de mon agent, corriger, et relancer seulement l’étape bornée en échec.
Sources primaires
Les affirmations techniques de ce guide sont reliées aux spécifications et documentations first-party.
- A practical guide to building agents (nouvel onglet)OpenAI · Cadre opérationnel : objectif, outils, instructions et garde-fous avant d’accorder de l’autonomie.
- Agents and the agent loop (nouvel onglet)OpenAI Agents SDK · La boucle s’arrête sur une sortie, un outil, un transfert ou une limite de tours — d’où l’intérêt d’une mission bornée.
- Trustworthy agents in practice (nouvel onglet)Anthropic · Contrôle humain, transparence et preuves plutôt qu’une confiance déclarée par l’agent.
Continuer
Guides et outils associés
Agent IA vs chatbot
Comprendre la boucle d’action avant de briefer une mission.
OuvrirCréer une Agent Skill avec SKILL.md
Quand une mission répétée mérite une procédure réutilisable.
OuvrirDécrire une interface sans ambiguïté
Donner des critères observables quand la mission touche une interface.
OuvrirFiche glossaire : agent
La définition sourcée du terme, ses critères et ses sources.
OuvrirComprendre → Reconnaître → Choisir → Comparer
Pack pour ton agent
Instruction pré-écrite par SkillCodex — ta demande n’est ni envoyée ni utilisée pour adapter ce texte ; aucun contenu n’est généré et copier n’exécute rien.
Utiliser dans ton agent
Préparer la mission
# Préparer la mission SkillCodex fournit ce Pack comme du texte statique à copier tel quel. Il ne le transmet pas, ne l’installe pas et ne l’exécute pas. Remplis les crochets dans ton agent, hors de SkillCodex. ## 1. Résultat observable et définition de done Écris le résultat que tu pourras constater sans rien changer : [RÉSULTAT OBSERVABLE]. - Observation : « le tableau affiche trois dates de livraison ». - Modification externe : « envoyer le tableau au client » — ce n’est pas un état de done. - Approbation humaine : « j’autorise l’envoi après lecture du tableau ». ## 2. Contexte et documents Fournis ce que l’agent doit lire : [CONTEXTE UTILE]. - Observation : « lis le devis PDF et le tableur v3, sans y écrire ». - Modification externe : « corrige le tableur v3 ». - Approbation humaine : « n’écris dans le tableur qu’après mon accord ». ## 3. Contraintes et non-objectifs Borne le périmètre : [CONTRAINTES ET NON-OBJECTIFS]. - Observation : « le tarif actuel est de 40 € ; constate-le seulement ». - Modification externe : « ne change pas le tarif ». - Approbation humaine : « tout changement de tarif attend ma décision ». ## 4. Lire ou analyser, puis modifier, envoyer ou dépenser Lire et analyser restent des observations. Modifier, envoyer ou dépenser sont des modifications externes. Sans demande, l’agent ne modifie pas, n’envoie pas et ne dépense pas. Actions encore bloquées : [ACTIONS À APPROUVER]. - Observation : un résumé dans la conversation. - Modification externe : un fichier changé, un message parti, un paiement. - Approbation humaine : tu autorises une cible précise, pas une famille d’actions. ## 5. Approbations et format de preuve Toute action coûteuse, publique ou destructive attend ton accord. Demande une preuve, pas un paragraphe confiant : [FORMAT DE PREUVE]. - Observation : capture, extrait, compte, fichier avant/après. - Modification externe : journal de ce qui a été écrit, envoyé, payé ou détruit. - Approbation humaine : ta décision, la cible, et le moment du oui ou du non. ## Garde-fous - Montre d’abord les changements envisagés avant toute action externe. - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite. - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu. ## Format de sortie - Résultat obtenu ou verdict. - Fichiers ou actions concernés. - Vérifications exécutées et preuves observables. - Blocages ou limites restantes.
- Prérequis · Le résultat observable, le contexte utile, et les actions encore interdites sans ton accord
Pourquoi ça marche
- La mission sépare observation, modification externe et approbation humaine.
- Les crochets se remplissent hors de SkillCodex, dans ton agent.
- Les actions coûteuses, publiques ou destructives restent bloquées tant que tu n’as pas approuvé.
À essayer ensuite
Vérifier le résultat de la mission
# Vérifier le résultat de la mission ## Objectif Contrôle la preuve observable, puis corrige seulement l’étape bornée en échec. ## Contrôles - Sépare ce que tu as observé, ce qui a été modifié, et ce que tu as approuvé. - Refuse un paragraphe confiant s’il ne respecte pas le format de preuve. - Relance uniquement l’étape divergente, pas toute la mission. ## Garde-fous - Montre d’abord les changements envisagés avant toute action externe. - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite. - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu. ## Format de sortie - Résultat obtenu ou verdict. - Fichiers ou actions concernés. - Vérifications exécutées et preuves observables. - Blocages ou limites restantes.
sha256:9e8b92ec7bac34b608b18f8958327f903eb3517f61297db30f1a704b21c6ae93
Vérifier dans ton agent
Vérifier le résultat
# Vérifier le résultat Ce bloc reste du texte statique : SkillCodex ne le transmet pas, ne l’installe pas et ne l’exécute pas. Remplis les crochets dans ton agent. ## Preuve contre définition de done Compare [PREUVE OBSERVÉE] au format déclaré et à la définition de done. - Observation : les trois dates sont-elles dans le tableau ? - Modification externe : un envoi, une écriture ou un paiement a-t-il eu lieu hors mission ? - Approbation humaine : une action bloquée a-t-elle couru sans ton accord ? ## Étape en échec Isole [ÉTAPE EN ÉCHEC]. Ne relance pas toute la mission. - Observation : quelle preuve manque ou contredit le done ? - Modification externe : quel fichier, message, paiement ou suppression a dépassé le périmètre ? - Approbation humaine : quelle décision manquait avant cette action ? ## Correction bornée Décris [CORRECTION BORNÉE] comme une nouvelle modification externe limitée à l’étape en échec. Redemande une approbation si l’étape reste coûteuse, publique ou destructive. - Observation : la nouvelle preuve doit pouvoir se constater sans autre action. - Modification externe : seulement l’étape isolée, pas un rejeu complet. - Approbation humaine : un nouveau oui, daté, sur une cible précise. ## Garde-fous - Montre d’abord les changements envisagés avant toute action externe. - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite. - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu. ## Format de sortie - Résultat obtenu ou verdict. - Fichiers ou actions concernés. - Vérifications exécutées et preuves observables. - Blocages ou limites restantes.
- Prérequis · Le résultat observable, le contexte utile, et les actions encore interdites sans ton accord
Pourquoi ça marche
- La preuve observable remplace un paragraphe confiant.
- Tu ne relances que l’étape bornée qui a échoué.
- Une correction est une nouvelle modification externe, pas une observation.
À essayer ensuite
Reprendre une mission bornée
# Reprendre une mission bornée ## Objectif Réécris le brief avec le résultat observable, les limites, et les approbations encore nécessaires. ## Contrôles - Le done reste une observation, pas une action déjà exécutée. - Lire et analyser restent séparés de modifier, envoyer et dépenser. - Chaque action coûteuse, publique ou destructive attend encore ton accord. ## Garde-fous - Montre d’abord les changements envisagés avant toute action externe. - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite. - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu. ## Format de sortie - Résultat obtenu ou verdict. - Fichiers ou actions concernés. - Vérifications exécutées et preuves observables. - Blocages ou limites restantes.
sha256:aaf2e5706913a104730800682a7275a135e0b0ffe987b6e3cf4c6261d7c2ab8f
Digest du Pack: sha256:fa1b6fd3d9cb61fba307b3af597b098c135278342e272caeb7d521eae4911c80