Acionadores
Um agente publicado e ativo pode ser disparado de quatro formas. Todas acionam a mesma definição — não existem tipos diferentes de agente.
| Acionador | Quem dispara | Quando usar |
|---|---|---|
| Manual | Uma pessoa, pelo Studio ou por API | Execução sob demanda |
| Agendamento | O relógio | Rotinas periódicas |
| Endereço HTTP | Outro sistema | Integração |
| Outro agente | Um fluxo | Composição |
Todo acionador aponta para uma versão exata
Um acionador aponta para uma versão ativa específica, nunca para "a mais recente". Publicar uma versão nova não muda sozinha o que um agendamento executa — o que acontece é a versão anterior deixar de estar ativa.
Isso é deliberado: um agendamento que trocasse de versão sozinho passaria a rodar, às três da manhã, algo que ninguém testou.
Manual
Aciona pelo Studio, informando os dados de entrada em um formulário montado a partir do que o agente declara.
Também é possível acionar por API — útil para scripts. Ver API.
Há um limite de acionamentos manuais por pessoa e por minuto. Ele existe para impedir enxurrada, não para atrapalhar o uso normal.
Agendamento
Ver página própria: Agendamentos.
Endereço HTTP
Ver página própria: Endereços HTTP.
Chamada de outro agente
Configurada dentro do fluxo que chama, pela etapa Chamar outro agente. Ver Chamar outro agente.
Diferenças por ambiente
development | production | |
|---|---|---|
| Endereço HTTP | Sempre temporário (expira) | Pode ser permanente |
| Agendamento | Sempre expira | Durável |
| Perfil para criar | Quem constrói | Quem publica |
Um teste esquecido em development para sozinho. Um acionador de produção é decisão de quem responde por ela.
Repetir uma execução
Repetir cria uma execução nova, a partir da mesma versão ativa. Não reaproveita a anterior — o histórico dela é imutável.
Você pode repetir com a mesma entrada ou informar outra. Repetir uma execução de produção exige perfil de publicação.
Como o disparo é registrado
Toda execução registra três coisas separadamente:
| Eixo | Exemplo |
|---|---|
| Quem pediu | Uma pessoa, ou a execução que chamou |
| Como foi disparada | Manual, agendamento, endereço, outro agente, repetição |
| Sob qual identidade rodou | A conta de execução da organização |
Repetição é registrada como um tipo próprio, e não como disparo novo: misturar as duas esconderia uma repetição em massa nas métricas.
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.