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.
doublex triggers list | create | update | run | delete | appsTipos#
| Tipo | Opção | Quando roda |
|---|---|---|
| Agendado | --cron "<expressão>" ou --describe "<frase>" | Num horário recorrente. |
| Único | --once <data e hora> | Uma vez, no horário marcado. |
| Webhook | --webhook | Quando 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#
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_PauloA 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:
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_6a2c4e8b1d3fA 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#
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#
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:
doublex triggers apps| Evento | Dispara quando | Parâmetros |
|---|---|---|
gmail.new_email | Chega um e-mail | query: filtro do Gmail, por exemplo from:cliente.com is:unread |
google-calendar.new_event | Um evento novo aparece na agenda | calendar_id (padrão primary) |
google-calendar.event_starting | Um evento vai começar | calendar_id, minutes_before (padrão 15) |
google-drive.new_file | Um arquivo novo aparece no Drive | folder: pasta a observar |
google-sheets.new_row | Uma linha nova aparece na planilha | spreadsheet (obrigatório), sheet |
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ção | Para 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. |
--raw | Webhook e app: manda só o JSON do evento, sem prompt. |
Listar, editar e rodar#
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 --yesupdateaceita--name,--prompt,--cron(e as formas simples),--once,--model(nonevolta ao modelo do agente),--timezone,--raw,--enablee--disable. O tipo do gatilho não muda: para trocar, apague e crie outro.runroda 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.