DoubleX AgentesDocs

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.

Terminal
doublex triggers list | create | update | run | delete | apps

Tipos#

TipoOpciónCuá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--webhookCuando 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#

Terminal
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_Paulo

La 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:

Terminal
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_6a2c4e8b1d3f

La 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#

Terminal
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#

Terminal
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:

Terminal
doublex triggers apps
EventoSe dispara cuandoParámetros
gmail.new_emailLlega un correoquery: filtro de Gmail, por ejemplo from:cliente.com is:unread
google-calendar.new_eventAparece un evento nuevo en el calendariocalendar_id (predeterminado: primary)
google-calendar.event_startingUn evento está por empezarcalendar_id, minutes_before (predeterminado: 15)
google-drive.new_fileAparece un archivo nuevo en Drivefolder: carpeta que se vigila
google-sheets.new_rowAparece una fila nueva en la hoja de cálculospreadsheet (obligatorio), sheet
Terminal
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ónPara 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.
--rawWebhook y app: envía solo el JSON del evento, sin prompt.

Listar, editar y ejecutar#

Terminal
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 --yes
  • update acepta --name, --prompt, --cron (y las formas simples), --once, --model (none vuelve al modelo del agente), --timezone, --raw, --enable y --disable. El tipo del disparador no cambia: para cambiarlo, borra el disparador y crea otro.
  • run ejecuta 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.