Seu agente inicia quando
algo realmente acontece

É um gatilho que inicia um agente de IA quando um serviço externo lhe envia um evento, em vez de em um horário definido. O AgentsRoom dá ao gatilho uma URL pública e um segredo de assinatura; você cola a URL no GitHub, GitLab, Slack, Linear, Sentry ou em qualquer ferramenta capaz de enviar um POST JSON. Quando esse serviço chama, a assinatura é verificada, o seu filtro opcional é aplicado, e um agente inicia no seu projeto com o payload já disponível como variáveis do prompt.

Só muda a pergunta 'quando isso dispara'. Uma tarefa agendada dispara em um relógio (a cada N minutos, horária, diária em um ou vários horários, semanal ou mensal) ou na janela de quota do seu plano de IA (quando a quota volta, ou antes de ela ser reposta). Um gatilho webhook dispara em um evento vindo de fora. Um gatilho a pedido não dispara em nada: ele espera que você aperte o botão dele. Todo o resto é compartilhado: a mesma lista, o mesmo interruptor de ligar e desligar, a mesma configuração de agente, o mesmo histórico por execução, o mesmo escopo por máquina.

Porque consultar custa tokens a cada volta, e quase toda volta não encontra nada. Um agente que verifica um repositório a cada cinco minutos roda um turno inteiro a cada cinco minutos para responder 'não'. Um gatilho webhook não consome nada enquanto nada acontece, e reage em poucos segundos quando algo acontece. Esse é todo o argumento econômico da funcionalidade.

A URL sozinha não basta para iniciar nada. Toda chamada precisa provar que vem do serviço que tem o seu segredo: X-Hub-Signature-256 para o GitHub, X-Slack-Signature para o Slack, o token compartilhado X-Gitlab-Token para o GitLab, um HMAC simples do corpo bruto para o Linear e o Sentry, e uma assinatura que também cobre um timestamp e um identificador de entrega para as fontes genéricas, de modo que uma chamada interceptada não pode ser enviada de novo. Uma chamada sem cabeçalho de assinatura é rejeitada, nunca liberada. O segredo aparece no editor e pode ser gerado de novo a qualquer momento, o que invalida na hora tudo o que usava o antigo.

Sim. Um repositório envia muito mais eventos do que você quer agentes, então um gatilho aceita uma condição opcional sobre o payload, por exemplo action igual a opened. Os eventos que não correspondem são ignorados e nada é criado. Também existe um limite de rajada: no máximo uma execução por janela de tempo, com as chamadas que chegam dentro dessa janela agrupadas.

O evento fica na fila no servidor e é reenviado na próxima vez que você abrir o app, então ele roda atrasado em vez de nunca rodar. Os eventos na fila são guardados por uma semana, o que cobre um laptop fechado durante um feriado prolongado sem reenviar um mês de trabalho velho quando você volta. É o mesmo modelo in-app com recuperação que as tarefas agendadas usam. Os gatilhos webhook não rodam o seu agente na nuvem: o agente sempre roda na sua máquina, no seu projeto.

Não. Um evento é consumido uma única vez. A primeira máquina que o pegar o trava, e as outras veem que ele já foi tomado e o pulam. Você também pode fixar um gatilho em máquinas específicas, exatamente como em uma tarefa agendada, se quiser que um computador em particular seja o dono dele.

O payload é convertido em variáveis que você escreve direto no campo do prompt, entre chaves duplas: event.title, event.author, event.url, event.number, event.branch, e payload para todo o JSON bruto. Elas são resolvidas quando o gatilho dispara, do mesmo jeito que as variáveis de data e hora de uma tarefa agendada.

O editor mostra a última chamada que o gatilho recebeu, incluindo o corpo JSON bruto, e permite reenviá-la com um clique. Assim você configura o filtro e o prompt contra um payload real que você enxerga, e reenvia até a execução ficar certa, em vez de empurrar commits de teste para descobrir.

Qualquer serviço capaz de enviar um POST assinado com um corpo JSON. GitHub, GitLab, Slack, Linear e Sentry são os que as pessoas ligam primeiro porque seus payloads são ricos, mas não existe lista de permitidos: um job de CI, uma ferramenta de monitoramento, o seu próprio backend ou um curl em um script shell funcionam exatamente da mesma forma.

Não, e não é isso que ele quer ser. Um gatilho tem uma única função: decidir quando uma execução começa e entregar o evento a ela. A parte de várias etapas pertence àquilo para onde ele aponta. Normalmente é um agente sozinho, que lê o código, roda as ferramentas e faz o trabalho; quando você quer que vários agentes passem trabalho uns para os outros, aponte o gatilho para um Agent Team e o evento inicia o pipeline inteiro, portões de qualidade e loops de feedback incluídos. O que você nunca desenha aqui é um quadro de cenários feito de caixas e setas em volta de uma API.

Os gatilhos são apenas de entrada: o AgentsRoom recebe eventos, ele não os emite. Se você quer que um agente chame um serviço externo no fim de uma execução, isso é trabalho do próprio agente, com as ferramentas e os servidores MCP que você deu a ele.

Sim, com uma execução restrita. Um payload escrito por um desconhecido pode esconder instruções dirigidas ao agente, então o AgentsRoom não conta com o prompt para contê-las: em uma execução restrita, a própria CLI do agente nega o acesso ao shell, à web e a todas as ferramentas do AgentsRoom, mantém os arquivos do projeto como somente leitura e só chama as ferramentas MCP que você permitiu. Dê ao gatilho a sua própria credencial por meio do servidor MCP que precisa dela, e o agente pode publicar a revisão sem nunca ver o token. O Claude Code e o Codex oferecem suporte a isso; as outras CLIs se recusam a iniciar uma execução assim.

Sim. Além de um agente ou de uma equipe, um gatilho pode executar uma ação do quadro: Iniciar o próximo ticket Por fazer. Ela faz exatamente o que o botão do quadro faz, pega o primeiro ticket de Por fazer pulando os que ainda estão bloqueados por outro, e o inicia com o próprio agente ou equipe. O gatilho em si não tem prompt e não faz nenhuma chamada de IA, então um pull request mesclado, uma execução de CI verde ou um horário podem manter um pipeline de um ticket, um agente andando sem pagar um turno de agente cujo único trabalho seria apertar esse botão.