CLI › Comandos
Disparadores
Haz que los agentes trabajen solos, a una hora, una única vez, por webhook o cuando algo pasa en una app.
Un disparador ejecuta un agente sin que nadie envíe un mensaje. Cada ejecución se convierte en una conversación en la pantalla Tareas, con origen Disparador o Webhook.
doublex triggers list | create | update | run | delete | appsTipos#
| Tipo | Opción | Cuándo se ejecuta |
|---|---|---|
| Programado | --cron "<expresión>" o --describe "<frase>" | A una hora recurrente. |
| Único | --once <fecha y hora> | Una vez, a la hora indicada. |
| Webhook | --webhook | Cuando otro sistema llama a la dirección del disparador. Consulta Webhooks. |
| De app | --app <evento> --connector <id> | Cuando llega un correo, se crea un evento en el calendario, aparece un archivo en Drive o una fila nueva en la hoja de cálculo. |
Programado#
doublex triggers create agt_8f3a2b1c9d0e --name "Briefing de las 8h" \
--prompt "Genera el briefing diario de hoy y envíalo a mi correo" \
--cron "0 8 * * 1-5" --timezone America/Sao_PauloLa expresión cron tiene 5 campos (minuto, hora, día del mes, mes, día de la semana). El intervalo mínimo es de 5 minutos.
¿Prefieres escribirlo en español? Usa --describe y el servidor convierte la frase en cron:
doublex triggers create agt_8f3a2b1c9d0e --name "Informe semanal" \
--prompt "Arma el informe de ventas de la semana" \
--describe "todos los viernes a las 17:30"cron: 30 17 * * 5
trg_6a2c4e8b1d3fLa conversión usa un modelo de IA y consume algunos créditos. También funcionan los formatos simples --every <minutos>, --daily HH:MM y --weekly <día>@HH:MM (día de 0, domingo, a 6, sábado).
Único#
doublex triggers create agt_8f3a2b1c9d0e --name "Recordatorio de la renovación" \
--prompt "Revisa si se renovó el contrato de Empresa SA y avísame" \
--once "2026-11-03T14:00"La fecha tiene que estar en el futuro. Sin zona horaria en la fecha, la CLI usa la zona horaria de tu computadora; para fijar otra, incluye el desplazamiento, como en 2026-11-03T14:00-03:00.
Webhook#
doublex triggers create agt_8f3a2b1c9d0e --name "Nuevo lead" --webhook \
--prompt "Llegó un lead: {{nombre}} ({{email}}). Califícalo y regístralo en el CRM."La CLI muestra la dirección y el secreto del webhook. Con --raw, el agente recibe solo el JSON del cuerpo, sin prompt.
De app#
Consulta los eventos disponibles y tus cuentas conectadas:
doublex triggers apps| Evento | Se dispara cuando | Parámetros |
|---|---|---|
gmail.new_email | Llega un correo | query: filtro de Gmail, por ejemplo from:cliente.com is:unread |
google-calendar.new_event | Aparece un evento nuevo en el calendario | calendar_id (predeterminado: primary) |
google-calendar.event_starting | Un evento está por empezar | calendar_id, minutes_before (predeterminado: 15) |
google-drive.new_file | Aparece un archivo nuevo en Drive | folder: carpeta que se vigila |
google-sheets.new_row | Aparece una fila nueva en la hoja de cálculo | spreadsheet (obligatorio), sheet |
doublex triggers create agt_2b7e4c6a1f3d --name "Pedido por correo" \
--app gmail.new_email --connector con_7a9b1c3d5e2f --param "query=subject:pedido is:unread" \
--prompt "Llegó un pedido de {{from}}: {{subject}}. Regístralo en la hoja de pedidos y responde para confirmarlo."El prompt puede mencionar los campos del evento entre llaves dobles: {{from}}, {{subject}}, {{body}} en Gmail; {{title}}, {{start}}, {{attendees}} en el calendario; {{name}}, {{link}} en Drive; {{row}} en las hojas de cálculo. El conector tiene que ser tuyo (o estar compartido contigo) y del mismo servicio que el evento.
La plataforma consulta la app cada dos minutos. La primera consulta solo marca el punto de partida: lo que ya existía antes del disparador no lo activa.
Opciones comunes#
| Opción | Para qué |
|---|---|
--name <nombre> | Obligatoria. Hasta 80 caracteres. |
--prompt <texto> | Lo que debe hacer el agente (hasta 4.000 caracteres). Acepta - (stdin) y --prompt-file <archivo>. |
--model <proveedor/modelo> | Modelo solo para este disparador. auto es DoubleX Auto. Sin ella, se usa el modelo del agente. |
--timezone <zona> | Zona horaria IANA de los disparadores programados y únicos. La predeterminada es America/Sao_Paulo. |
--raw | Webhook y app: envía solo el JSON del evento, sin prompt. |
Listar, editar y ejecutar#
doublex triggers list --agent agt_8f3a2b1c9d0e
doublex triggers update trg_6a2c4e8b1d3f --cron "0 9 * * 1-5" --model none
doublex triggers update trg_6a2c4e8b1d3f --disable
doublex triggers run trg_6a2c4e8b1d3f
doublex triggers delete trg_6a2c4e8b1d3f --yesupdateacepta--name,--prompt,--cron(y las formas simples),--once,--model(nonevuelve al modelo del agente),--timezone,--raw,--enabley--disable. El tipo del disparador no cambia: para cambiarlo, borra el disparador y crea otro.runejecuta el disparador ahora, en segundo plano. En un disparador de app, hace la consulta en ese momento y muestra cuántos elementos nuevos encontró.- La lista muestra cuándo se ejecuta cada disparador, si está activo y la próxima ejecución.