Playbooks : orchestrez vos agents

Qu'est-ce qu'un Playbook ?

Un Playbook est un pipeline séquentiel d'agents. Chaque agent exécute sa tâche, puis transmet son résultat au suivant via le champ previous_result. Contrairement à un agent unique qui combine des outils dans un seul workflow, un Playbook orchestre des agents indépendants — chacun peut être testé, maintenu et réutilisé séparément.

La page Playbooks

Accédez aux Playbooks depuis la sidebar. La page affiche vos playbooks avec leurs étapes, leur statut et les actions disponibles.

Créer un Playbook

1. Cliquez sur Nouveau Playbook
2. Donnez un nom et une description claire
3. Ajoutez des étapes en sélectionnant vos agents existants dans l'ordre souhaité
4. Chaque agent reçoit le résultat du précédent comme entrée
5. Activez stop_on_error si le pipeline doit s'arrêter en cas d'échec

Exemples concrets

• Veille concurrentielle : Agent Web Search (recherche) → Agent LLM (analyse et résumé) → Agent Gmail (envoi du rapport) → Agent Slack (notification équipe)
• Onboarding client : Agent Gmail (email de bienvenue) → Agent Drive (création dossier) → Agent Calendar (planification réunion)
• Rapport hebdomadaire : Agent Spreadsheet (collecte KPI) → Agent LLM (analyse) → Agent Gmail (rapport) → Agent Telegram (résumé mobile)
• Pipeline de recrutement : Agent Gmail (réception CV) → Agent Workspace (sauvegarde) → Agent LLM (analyse et scoring) → Agent Spreadsheet (classement)

Flux de données entre agents

Le chaînage est simple mais puissant :

• Agent 1 s'exécute et produit un result (texte, JSON...)
• Agent 2 reçoit ce résultat dans previous_result
• Agent 3 reçoit le résultat de l'Agent 2, et ainsi de suite

Chaque exécution est tracée : statut (pending, running, completed, failed), durée, résultat détaillé et timestamps.

Modes de déclenchement

• Manuel — Exécution à la demande via le bouton Lancer
• Horaire (CRON) — Ex : 0 8 * * * (tous les jours à 8h), 0 9 * * 1 (chaque lundi à 9h)
• Webhook — Déclenchement via URL HTTP (Stripe, GitHub, Zapier)

Bonnes pratiques

• Agents atomiques — Un agent = une tâche. Plus facile à débugger et réutiliser
• Testez chaque agent individuellement avant de les chaîner
• Nommez explicitement vos agents et playbooks pour faciliter la maintenance
• Activez stop_on_error pour les pipelines critiques
• Surveillez les exécutions — chaque étape a son propre statut et ses logs