Agents d'automatisation & Hooks
Ce que vous allez apprendre
Dans cette page vous apprendrez, pas à pas et sans jargon, à :
- Créer, éditer et dupliquer des agents d’automatisation (flux d’étapes en JSON).
- Associer un modèle LLM à un agent et l’exécuter manuellement ou via un AgentHook.
- Configurer des AgentHooks : fréquence (count + duration), filtres (branches, fichiers, auteurs), planning, et destinations (e‑mail, Notion, webhooks).
- Tester vos hooks avec une prévisualisation et comprendre comment le serveur dispatch les événements (push/PR) vers les hooks et pipelines. Cette page est la 4ᵉ de 11 du guide.
Agents d'automatisation & Hooks
Créez des agents, planifiez leurs exécutions et envoyez les résultats là où vous en avez besoin
Automatisez les tâches récurrentes (génération d’articles, checks SEO, synthèse de PR) et contrôlez quand et sur quoi elles s’exécutent.
Fonctionnalités clés
Créer & éditer
Créez des agents composés d’étapes au format JSON, modifiez-les à tout moment et sauvegardez les versions.
Templates & duplication
Démarrez d’un template (ex : SEO Article Generator), ou dupliquez un agent existant pour tester sans risquer l’original.
Hooks programmés
Planifiez des exécutions via fréquence (count + duration), filtres par branche/fichier/auteur, et recevez les résultats par email, Notion ou webhooks.
LLM par agent
Associez un modèle LLM spécifique à chaque agent pour contrôler le ton, la qualité ou le coût.
Preview & tests
Prévisualisez les documents générés par un hook avant d’activer l’exécution réelle.
Dispatch côté serveur
Le serveur routage les événements repository (push/PR) vers les AgentHooks et pipelines (fichier : server/events/repositoryEvents.ts).
Créer, éditer, dupliquer et lancer un agent — pas à pas
Créer un agent
- Ouvrez le dialogue “Agent” dans l’interface.
- Donnez un nom clair (ex : “SEO Article Generator”).
- Collez ou écrivez vos étapes en JSON (flux d’étapes). Exemple simple : un step de génération + un step de formatage.
- Sélectionnez le modèle LLM à associer (ex : gpt-4).
- Cliquez sur “Sauvegarder”.
Éditer un agent
- Ouvrez l’agent existant depuis la liste.
- Modifiez les étapes JSON (ajoutez/supprimez étapes, changez prompts).
- Sauvegardez. Les changements sont appliqués à la prochaine exécution.
Dupliquer un agent
- Sélectionnez l’agent à copier.
- Cliquez sur “Duplicate” (Dupliquer).
- Une nouvelle copie est créée que vous pouvez renommer et modifier sans impacter l’original.
Exécuter manuellement un agent
- Dans la page de l’agent, cliquez sur “Run” ou “Exécuter”.
- Choisissez les inputs (ex : fichier ou PR) et lancez.
- Consultez le résultat dans l’interface ou envoyez-le vers une destination configurée.
Associer un agent à un hook
- Lors de la création d’un AgentHook (voir section suivante), sélectionnez l’agent à exécuter.
- Le hook déclenchera l’agent selon la planification et les filtres que vous définissez.
Astuce rapide
Utilisez un template comme “SEO Article Generator” pour démarrer rapidement : testez-le en le dupliquant, adaptez le JSON aux prompts et au format que vous attendez, puis associez-le à un hook pour exécution automatique.
Configurer un AgentHook (triggers programmés et filtres) — guide simple
Ouvrir le dialogue AgentHook
- Cliquez sur “New Hook” ou “Créer AgentHook”.
- Donnez un nom explicite (ex : “Hook - Articles main branch”).
Sélectionner l'agent
- Choisissez l’agent à exécuter (ex : votre copie de SEO Article Generator).
Définir la fréquence (count + duration)
- Configurez quand le hook doit déclencher. Exemples :
- Tous les 1h (duration = 1h, count = 1)
- Dès que 10 commits sont arrivés dans 2 heures (count = 10, duration = 2h)
- Le scheduler calculera next_execution_at et lancera les jobs dûs.
Ajouter des filtres d'inputs
- Filtrez par branche (ex : main), par fichiers modifiés (ex : docs/*.md) ou par auteurs (ex : @alice).
- Les filtres limitent les cas où l’agent s’exécute — utile pour éviter les exécutions inutiles.
Choisir les destinations des outputs
- Sélectionnez où envoyer les résultats : e‑mail, Notion, ou un webhook externe.
- Vous pouvez activer plusieurs destinations en parallèle.
Tester et prévisualiser
- Utilisez “Preview documents” pour voir des exemples de sorties basés sur les filtres sélectionnés.
- Ajustez prompts/JSON avant d’activer le hook si le rendu ne correspond pas.
Sauvegarder et activer
- Sauvegardez le hook.
- Une fois activé, le scheduler exécutera les hooks planifiés et mettra à jour next_execution_at.
Gérer jobs en cours
- Si nécessaire, annulez des exécutions via “Cancel jobs” au niveau du projet.
- Les hooks planifiés resteront, mais les jobs en cours peuvent être stoppés.
Déclencher via événements repository (push/PR)
- Le serveur reçoit les événements push/PR et les route vers les AgentHooks/pipelines (voir server/events/repositoryEvents.ts).
- Les hooks appliquent leurs filtres (branches/fichiers/auteurs) avant de lancer l’agent.
Erreurs courantes à éviter
- Ne laissez pas de JSON invalide dans les steps : un JSON mal formé empêche l’agent de s’exécuter.
- Attention aux filtres trop larges (ex : aucune restriction) — cela peut générer de nombreuses exécutions et des coûts inattendus.
- N’oubliez pas d’associer un modèle LLM à chaque agent : sans modèle sélectionné, l’agent ne produira pas de contenu.
Exemples de configuration de fréquence :
- Run every 15m : duration = 15m, count = 1
- Après 5 commits en 24h : duration = 24h, count = 5
- Exécutions quotidiennes à 03:00 (scheduler horaire)
Exemples de filtres utiles :
- Branches : main, release/*
- Fichiers : docs/*.md, content/blog/**
- Auteurs : @alice, @ci-bot
Checklist rapide avant activation
- Agent : nom clair, steps JSON valides, modèle LLM sélectionné.
- Hook : fréquence définie, filtres testés, destinations correctes.
- Tester : utiliser “Preview documents” puis exécuter manuellement une première fois.
Organisation recommandée
Créez un agent par tâche métier (ex : “Génération SEO”, “Résumé PR”, “Vérif. licence”). Dupliquez pour expérimenter et gardez un agent « production » immuable jusqu’à validation.
Exemples concrets (non techniques)
- SEO Article Generator : dupliquez le template, ajustez le prompt pour votre ton, associez main branch + fichiers content/blog/**, envoyez le résultat vers Notion.
- Résumé de PR : agent avec steps JSON pour extraire changements + résumer ; hook déclenché sur PRs, filtres auteur = anyone, destination = e‑mail aux reviewers.
Comment le serveur déclenche les hooks ?
Le serveur écoute les événements repository (push et PR) et les passe aux règles de routing. Le fichier de référence côté serveur est server/events/repositoryEvents.ts — c’est là que les push/PR sont dispatchés vers les AgentHooks et pipelines, puis les filtres sont appliqués avant exécution.
Prêt à automatiser vos tâches ?
Commencez par dupliquer un template (ex : SEO Article Generator) et créez un hook de test pour la branche main.
Next steps
- Suivant (page 5) : Flux de génération, revue & publication — apprenez à intégrer les résultats d’un agent dans votre workflow de publication.
- Revenir à la page précédente : Indexation & recherche RAG.
- Besoin d’aide ? Consultez la section “Chat contextuel & support” ou contactez l’équipe via l’interface.