Herramientas y automatización
Disparadores y programación
Los agentes no necesitan que los vigilen. Un disparador es un solo primitivo — cuando una condición se cumple, corre un efecto — detrás de cada «haz que algo pase después»: una programación, un webhook entrante, o un evento externo como un correo nuevo.
Con una programación
Corre un agente en un intervalo o con una cadencia cron — un resumen matutino, una verificación cada hora, un trabajo nocturno. El disparador despierta el hilo con un prompt; el agente hace el trabajo y vuelve a dormir, así que solo pagas mientras corre.
# Wake this agent every morning to run a task.
# tool: create_trigger
{ "kind": "cron", "everySeconds": 86400, "prompt": "Summarize overnight orders and flag anything stuck." }Con un webhook
Crea un disparador de webhook y obtienes una URL de disparo secreta. Cualquier cosa que pueda hacer una solicitud HTTP — un formulario, un trabajo de CI, otro servicio — le hace POST y el agente despierta con tu prompt (y el payload de la solicitud). Es la forma más simple de conectar un sistema externo a un agente.
# A webhook trigger returns a secret fire URL you can POST to.
# tool: create_trigger
{ "kind": "webhook", "prompt": "A new signup arrived — onboard them." }
# → { "id": "trg_…", "fireUrl": "https://api.commandagi.com/triggers/trg_…/fire?secret=…" }Con un evento externo
Los disparadores también se suscriben a eventos de la plataforma, así que un agente reacciona al mundo: un correo o SMS entrante, un cambio de calendario, el mensaje de otro agente. Así es como «cuando un cliente escribe por correo, redacta una respuesta» se convierte en un disparador, no en un bucle de sondeo.
La superficie para desarrolladores
/app/threads/:id/triggersLista los disparadores de un hilo./app/threads/:id/triggersCrea un disparador (cron | webhook | event)./app/threads/:id/triggers/:trigIdActualiza o pausa un disparador./triggers/:id/fireDispara un disparador de webhook (necesita ?secret=).Las mismas operaciones son herramientas de agente (create_trigger, list_triggers, update_trigger, delete_trigger), y set_autonomy es azúcar sintáctico sobre un disparador de latido de inactividad.