Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

SOP Fan-In: Manual

Un disparador manual inicia una ejecución desde dentro de un turno del agente, no desde un evento externo. El agente llama a la herramienta sop_execute, indicando el SOP que se va a ejecutar. No hay ningún listener ni ninguna fuente de eventos que configurar; la ejecución comienza cuando el agente decide iniciarla.

Usa un disparador manual cuando la decisión de ejecutar pertenezca al razonamiento del agente y no a una señal externa. Este es el camino que usa el ejemplo trabajado: llega un lanzamiento por un canal, el agente razona sobre ello y luego activa el SOP por sí mismo.

Definiéndolo

Un SOP con un desencadenador manual no tiene campos de coincidencia. Consulte Syntax para el bloque del desencadenador. Valídelo e inspecciónelo de la misma manera que cualquier otro SOP:

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

Iniciando uno desde el panel de control

El botón de ejecución del panel (POST /sops/{name}/run) emite el mismo evento manual, por lo que un disparador manual es accesible desde dos lados: un turno del agente y un operador sin ningún agente detrás. Una ejecución iniciada desde el panel se ejecuta en modo headless, exactamente igual que una ejecución de cron.

Esa diferencia se refleja en la titularidad. Mediante sop_execute, el agente que hace la llamada es el titular de la ejecución, por lo que agent es opcional. Una ejecución iniciada desde el panel no tiene ningún agente del que heredar, así que el endpoint rechaza un procedimiento cuyos pasos execute no declaran propietario (422, indicando los pasos) en lugar de iniciar una ejecución que fallaría en su primer paso. La creación advierte de esto en lugar de bloquearla, así que un procedimiento pensado solo para sop_execute se guarda igualmente. Define agent en SOP.toml (o en el paso) para que un SOP manual pueda iniciarse desde el panel.

Aprueba y observa

Las ejecuciones que alcanzan un punto de control se pausan como WaitingApproval. Límpialas o inspecciónalas con la CLI (zeroclaw sop list, zeroclaw sop approve) o fuera de banda mediante los endpoints de aprobación de la gateway API (GET /admin/sop/pending, POST /admin/sop/approve, POST /admin/sop/deny).

Ver también