Workflow d'approbation

Pourquoi les approbations existent#

Tout ce que fait un agent ne devrait pas passer sans verification. Les approbations ajoutent une etape de revue humaine au cycle de vie des taches : l'agent fait le travail, puis attend votre validation avant que la tache soit marquee comme terminee.

C'est utile pour :

• Les deploiements ou changements d'infrastructure
• Les taches qui modifient des donnees de production
• Les operations ou les erreurs sont couteuses a corriger

Activer les approbations#

Deux niveaux de controle :

Par tache -- lors de la creation, activez Requires Approval. Seule cette tache se mettra en pause pour revue.

Global -- dans les parametres de votre compte, activez Task Approval Mode. Quand c'est actif, chaque tache requiert une approbation, quel que soit le reglage par tache. Ca fournit un filet de securite sur toute l'activite des agents.

Le toggle global se trouve sous Settings > Mission Control > Task Approval.

Comment le flux d'approbation fonctionne#

1. Une tache avec requiresApproval: true s'execute normalement
2. Quand l'agent termine, la tache passe en Review (au lieu de Done)
3. Un enregistrement MissionApproval est cree et apparait dans le panneau Approvals
4. Vous examinez le resultat : logs, changements de fichiers, resultats
5. Vous Approuvez ou Rejetez

Si approuvee, la tache passe a Done.

Si rejetee, la tache passe a Failed. Vous pouvez ajouter un commentaire expliquant ce qui n'allait pas, utile pour reessayer avec un prompt revise.

Revoir une tache#

Depuis le tableau de bord Mission Control :

1. Cliquez sur la carte de la tache dans la colonne Review
2. Examinez la sortie, les logs et les fichiers modifies par l'agent
3. Cliquez sur Approve ou Reject
4. En cas de rejet, ajoutez une note expliquant ce qui doit changer

Via l'API :

# Approuver
curl -X POST https://lebureau.talentai.fr/api/mission-control/tasks/:id/review \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"decision": "approve"}'

# Rejeter avec commentaire
curl -X POST https://lebureau.talentai.fr/api/mission-control/tasks/:id/review \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"decision": "reject", "feedback": "Le nom de la base devrait etre myapp_staging, pas myapp_prod"}'

Gerer les approbations#

Le panneau Approvals dans Mission Control liste toutes les demandes en attente. Chaque entree montre la tache concernee, le bureau cible, la date de completion et un lien vers la sortie complete de la tache.

Vous pouvez aussi lister les approbations en attente via l'API :

curl https://lebureau.talentai.fr/api/mission-control/approvals \
  -H "x-api-key: your-api-key"

Et les resoudre :

curl -X POST https://lebureau.talentai.fr/api/mission-control/approvals/:id/resolve \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"decision": "approve"}'

Conseils#

• Commencez avec les approbations globales activees tant que vous ne faites pas encore confiance a vos workflows, puis passez au mode par tache pour les operations sensibles uniquement.
• Revoyez rapidement. Les taches en Review bloquent le travail en aval si d'autres taches en dependent.
• Un commentaire de rejet clair facilite la creation d'une tache de suivi qui aboutira.
• Vous pouvez associer une tache prompt (avec approbation) pour le travail creatif, puis une tache commande pour le deploiement.