Les Agent Hooks prennent en charge à la fois une action « requête d'agent » et une action « commande shell ». Une fois que vous avez sélectionné l'événement spécifique qui déclenche un hook, vous pouvez décider de l'action qui sera prise lorsque ce hook est déclenché.
Avec cette action, vous pouvez définir une requête qui est envoyée à l'agent chaque fois que le hook est déclenché. L'agent répondra et agira selon cette requête, tout comme il le fait avec une requête fournie dans le panneau de clavardage.
Dans le cas du déclencheur Prompt Submit, la requête spécifiée dans le hook est ajoutée à la requête de l'utilisateur, et la requête combinée est envoyée à l'agent.
Avec cette action, vous pouvez définir une commande shell qui est exécutée chaque fois que le hook est déclenché.
Si la commande retourne un code de sortie « 0 » indiquant la réussite, la sortie stdout de la commande est ajoutée au contexte de l'agent.
Si la commande retourne tout autre code de sortie, la sortie stderr de la commande est envoyée à l'agent, et l'agent est informé que le hook a retourné une erreur. De plus, dans le cas du hook Pre Tool Use, l'invocation de l'outil est bloquée, et pour le hook Prompt Submit, la soumission de la requête de l'utilisateur est bloquée.
Un délai d'expiration d'exécution peut être spécifié. Le délai par défaut est de 60 secondes. Réglez à 0 pour désactiver le délai d'expiration.
Vous devriez utiliser l'action Requête d'agent lorsque, en réponse à un événement déclencheur, vous voulez utiliser le langage naturel pour demander à l'agent d'effectuer une action en fonction du contexte.
Vous devriez utiliser l'action Commande shell lorsque vous voulez exécuter une commande spécifique ou effectuer un ensemble déterministe d'actions qui ne dépendent pas du contexte actuel de l'agent.
Actions des hooks