DoubleX AgentesDocs

CLI › Comandos

Gatilhos

Faça os agentes trabalharem sozinhos, num horário, uma única vez, por webhook ou quando algo acontece num app.

Um gatilho roda um agente sem ninguém mandar mensagem. Cada execução vira uma conversa na tela Tarefas, com origem Gatilho ou Webhook.

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

Tipos#

TipoOpçãoQuando roda
Agendado--cron "<expressão>" ou --describe "<frase>"Num horário recorrente.
Único--once <data e hora>Uma vez, no horário marcado.
Webhook--webhookQuando outro sistema chama o endereço do gatilho. Veja Webhooks.
De app--app <evento> --connector <id>Quando chega um e-mail, nasce um evento na agenda, aparece um arquivo no Drive ou uma linha nova na planilha.

Agendado#

Terminal
doublex triggers create agt_8f3a2b1c9d0e --name "Briefing das 8h" \
  --prompt "Gere o briefing diário de hoje e mande no meu e-mail" \
  --cron "0 8 * * 1-5" --timezone America/Sao_Paulo

A expressão cron tem 5 campos (minuto, hora, dia do mês, mês, dia da semana). O intervalo mínimo é de 5 minutos.

Prefere escrever em português? Use --describe e o servidor converte a frase em cron:

Terminal
doublex triggers create agt_8f3a2b1c9d0e --name "Relatório semanal" \
  --prompt "Monte o relatório de vendas da semana" \
  --describe "toda sexta às 17h30"
cron: 30 17 * * 5
trg_6a2c4e8b1d3f

A conversão usa um modelo de IA e consome alguns créditos. Também funcionam os formatos simples --every <minutos>, --daily HH:MM e --weekly <dia>@HH:MM (dia de 0, domingo, a 6, sábado).

Único#

Terminal
doublex triggers create agt_8f3a2b1c9d0e --name "Lembrete da renovação" \
  --prompt "Confira se o contrato da Empresa SA foi renovado e me avise" \
  --once "2026-11-03T14:00"

A data precisa estar no futuro. Sem fuso na data, a CLI usa o fuso do seu computador; para fixar outro, inclua o deslocamento, como em 2026-11-03T14:00-03:00.

Webhook#

Terminal
doublex triggers create agt_8f3a2b1c9d0e --name "Novo lead" --webhook \
  --prompt "Chegou um lead: {{nome}} ({{email}}). Qualifique e registre no CRM."

A CLI mostra o endereço e o segredo do webhook. Com --raw, o agente recebe só o JSON do corpo, sem prompt.

De app#

Veja os eventos disponíveis e as suas contas conectadas:

Terminal
doublex triggers apps
EventoDispara quandoParâmetros
gmail.new_emailChega um e-mailquery: filtro do Gmail, por exemplo from:cliente.com is:unread
google-calendar.new_eventUm evento novo aparece na agendacalendar_id (padrão primary)
google-calendar.event_startingUm evento vai começarcalendar_id, minutes_before (padrão 15)
google-drive.new_fileUm arquivo novo aparece no Drivefolder: pasta a observar
google-sheets.new_rowUma linha nova aparece na planilhaspreadsheet (obrigatório), sheet
Terminal
doublex triggers create agt_2b7e4c6a1f3d --name "Pedido por e-mail" \
  --app gmail.new_email --connector con_7a9b1c3d5e2f --param "query=subject:pedido is:unread" \
  --prompt "Chegou um pedido de {{from}}: {{subject}}. Registre na planilha de pedidos e responda confirmando."

O prompt pode citar os campos do evento entre chaves duplas: {{from}}, {{subject}}, {{body}} no Gmail; {{title}}, {{start}}, {{attendees}} na agenda; {{name}}, {{link}} no Drive; {{row}} nas planilhas. O conector precisa ser seu (ou compartilhado com você) e do mesmo serviço do evento.

A plataforma consulta o app a cada dois minutos. A primeira consulta só marca o ponto de partida: o que já existia antes do gatilho não dispara.

Opções comuns#

OpçãoPara quê
--name <nome>Obrigatória. Até 80 caracteres.
--prompt <texto>O que o agente deve fazer (até 4.000 caracteres). Aceita - (stdin) e --prompt-file <arquivo>.
--model <provedor/modelo>Modelo só para este gatilho. auto é o DoubleX Auto. Sem ela, vale o modelo do agente.
--timezone <fuso>Fuso IANA dos gatilhos agendados e únicos. O padrão é America/Sao_Paulo.
--rawWebhook e app: manda só o JSON do evento, sem prompt.

Listar, editar e rodar#

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 aceita --name, --prompt, --cron (e as formas simples), --once, --model (none volta ao modelo do agente), --timezone, --raw, --enable e --disable. O tipo do gatilho não muda: para trocar, apague e crie outro.
  • run roda o gatilho agora, em segundo plano. Num gatilho de app, faz a consulta na hora e mostra quantos itens novos achou.
  • A lista mostra quando cada gatilho roda, se está ativo e a próxima execução.