Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

SOP Fan-In : Manuel

Un déclencheur manuel lance une exécution depuis l’intérieur d’un tour de l’agent, et non à partir d’un événement externe. L’agent appelle l’outil sop_execute, en spécifiant le SOP à exécuter. Aucun écouteur ni source d’événement n’est à configurer ; l’exécution démarre lorsque l’agent décide de la lancer.

Utilisez un déclencheur manuel lorsque la décision d’exécuter relève du raisonnement de l’agent plutôt que d’un signal externe. C’est le chemin qu’utilise l’exemple détaillé : une version arrive via un canal, l’agent raisonne à son sujet, puis déclenche le SOP lui-même.

Le définir

Un SOP avec un déclencheur manual ne comporte aucun champ de correspondance. Consultez Syntaxe pour le bloc de déclencheur. Validez et inspectez-le de la même manière que tout autre SOP :

zeroclaw sop validate
zeroclaw sop list
zeroclaw sop show <name>

Démarrage d’une nouvelle session depuis le tableau de bord

Le bouton d’exécution du tableau de bord (POST /sops/{name}/run) émet le même événement manuel, si bien qu’un déclencheur manual est accessible depuis deux côtés : un tour d’agent, et un opérateur sans agent derrière lui. Une exécution lancée depuis le tableau de bord est pilotée en mode headless, exactement comme une exécution cron.

Cette différence se manifeste au niveau de la propriété. Via sop_execute, l’agent appelant possède l’exécution, donc agent est facultatif. Une exécution lancée depuis le tableau de bord n’a aucun agent dont hériter : le point de terminaison refuse donc une procédure dont les étapes execute ne déclarent aucun propriétaire (422, avec le nom des étapes concernées), plutôt que de démarrer une exécution qui échouerait à sa première étape. La création de procédures avertit de ce problème sans bloquer, si bien qu’une procédure destinée uniquement à sop_execute reste enregistrable. Définissez agent dans SOP.toml (ou sur l’étape) pour rendre une SOP manuelle démarrable depuis le tableau de bord.

Approuver et observer

Les exécutions qui atteignent un point de contrôle se mettent en pause en tant que WaitingApproval. Effacez-les ou inspectez-les avec le CLI (zeroclaw sop list, zeroclaw sop approve) ou hors bande via les endpoints d’approbation de la gateway API (GET /admin/sop/pending, POST /admin/sop/approve, POST /admin/sop/deny).

Voir aussi