Notion · Faire agir l’IA
Hook
Une action automatique déclenchée à un moment précis du travail d’un agent : avant une modification, après une commande, à la fin d’une tâche. Un contrôle qu’on n’a plus à penser.
Comment ça marche
Un agent suit vos consignes, la plupart du temps. Mais « la plupart du temps » ne suffit pas pour les règles qui comptent : ne jamais écrire dans tel dossier, toujours lancer les tests après une modification, prévenir quand une commande dangereuse est exécutée. Les hooks règlent ça en sortant la règle du modèle : à un événement donné, un script s’exécute, automatiquement, et peut bloquer, vérifier ou enregistrer.
Les événements typiques sont les moments où l’agent agit : juste avant qu’il utilise un outil (on peut refuser), juste après (on peut vérifier le résultat), quand il termine une tâche (on peut imposer un contrôle final), quand une session commence (on peut charger un contexte). Le hook reçoit les détails de l’action, fait son travail, et rend un verdict. L’agent ne peut pas le contourner, puisqu’il ne passe pas par lui.
Un exemple concret
- Avant toute écriture de fichier : si le chemin commence par clients/ et contient recus/, refuser. Les documents reçus des clients sont intouchables, quoi que dise la consigne.
- Après toute modification de code : lancer automatiquement les tests du projet. Si un test échoue, le résultat est renvoyé à l’agent, qui doit corriger avant de continuer.
- Avant toute commande qui contient « rm » ou « delete » : demander une confirmation humaine explicite, même en mode automatique.
- À la fin de chaque tâche : écrire dans un journal la liste des fichiers modifiés, l’heure et le résumé de la tâche. Le cabinet sait toujours ce que l’agent a fait.
Ces quatre règles existaient déjà dans le fichier de consignes. L’agent les suivait presque toujours. « Presque » a justifié les hooks.
Ce que ça change pour une équipe
- Certaines règles deviennent absolues. Les interdits de sécurité, les contrôles de qualité, la traçabilité : on arrête de compter sur la discipline du modèle.
- L’autonomie de l’agent peut augmenter. Avec des hooks qui bloquent le pire, on peut laisser l’agent travailler plus longtemps seul.
- La qualité est vérifiée mécaniquement. Tests, mise en forme, vérification de format : automatiques, à chaque fois, sans y penser.
- Tout est journalisé. Les hooks de fin de tâche produisent l’historique dont on a besoin pour comprendre et pour rendre compte.
Les limites et les erreurs fréquentes
- Tout mettre en hooks. Un hook à chaque action ralentit l’agent et complique le système. On réserve les hooks aux règles qui ne souffrent pas d’exception.
- Le hook qui casse silencieusement. Un script qui échoue sans le dire laisse croire que la règle est appliquée. Les hooks se testent, comme le reste.
- Confondre hook et sandbox. Un hook bloque ce qu’il voit passer. Un agent qui trouve un autre chemin vers la même action n’est pas arrêté. L’isolation reste nécessaire.
- Oublier de les versionner. Les hooks font partie de la configuration du projet. Ils se partagent et se suivent avec le reste.
Pour aller plus loin
Les hooks exécutent un script sur des événements du cycle de vie de l’agent, pour valider, bloquer, formater ou notifier. Ils rendent certaines règles non négociables, là où une consigne écrite peut être oubliée.
Où ça se situe chez Opora
Programme 04 · Construire des agentsIngénierie agentique pour les équipes techniques
Mettre en place les hooks qui imposent vos règles à un agent sans dépendre de sa bonne volonté, c’est une des pratiques du programme Construire des agents.
Questions fréquentes
Quelle différence entre un hook et une consigne ?
Une consigne est une règle que l’agent lit et essaie de suivre. Un hook est un mécanisme qui s’exécute quoi qu’il arrive, en dehors du modèle : il peut bloquer une action, la vérifier, la journaliser. La consigne dit « ne fais pas ça » ; le hook fait que ça ne se produit pas.
Faut-il savoir programmer pour créer un hook ?
Un hook, c’est un petit script ou une commande déclenchée sur un événement. Les plus simples tiennent en une ligne : lancer les tests, vérifier qu’un fichier n’est pas touché, envoyer une notification. Un agent de code peut écrire le hook lui-même à partir de votre description.
Sur quels événements peut-on brancher un hook ?
Selon l’outil : avant ou après chaque utilisation d’un outil par l’agent (lecture, écriture, commande), au début ou à la fin d’une session, quand l’agent s’apprête à rendre la main, quand une sous-tâche se termine. Claude Code en propose une dizaine ; d’autres outils ont leurs équivalents.