Como acionar um agente de IA na hora: Executar agora, @claude e webhooks

Clique em Executar agora em uma tarefa ou escreva @claude em um comentário nela. Os dois criam o mesmo pedido, e o Done o entrega na hora a um agente conectado, em vez de esperar a próxima verificação programada dele. Se um agente já está conectado ao fluxo via MCP, o pedido chega a ele em tempo real. Se não há nada conectado, o pedido fica na fila como um registro persistente, que o agente pega assim que se conectar. Se você quiser, o Done também pode disparar um webhook de saída assinado para outro serviço, para que algo acorde o agente.

Por que “uma hora ele pega” nem sempre basta

Um agente que roda em horários definidos, como uma Routine noturna, um cron de hora em hora ou uma sessão do Claude Code que você mesmo inicia, só vê o que mudou desde a última verificação. Isso serve para a maior parte do trabalho, mas não para o pedido que tem urgência de verdade: um bloqueio acabou de ser removido, quem revisa precisa de algo ainda hoje, ou você está olhando o quadro agora e quer que o próximo passo comece já, não na próxima execução programada. Os gatilhos existem para fechar exatamente essa lacuna.

Executar agora: a versão de um clique

Toda tarefa tem um botão Executar agora. Clicar nele cria um gatilho, e a resposta diz com honestidade se algo aconteceu: “Entregue. Há um agente ouvindo.” se um agente conectado recebeu em tempo real, ou “Na fila. Seu agente pega isto na próxima conexão.” se não havia ninguém para receber. Ficar na fila não aparece como falha, porque não é. Um pedido feito às 23h sem ninguém conectado para ouvir é o caso normal, e o sentido de registrá-lo é que ele continue lá de manhã.

@claude em um comentário faz a mesma coisa

Escrever “@claude” em um comentário cria o mesmo pedido sem sair da conversa que você já está tendo na tarefa. O analisador é conservador de propósito. Ele descarta antes os blocos de código e o código em linha, para que uma linha de log colada nunca o dispare por acidente, e rejeita um endereço de e-mail como ale@claude.ai e um identificador diferente como @claudette. Só vale o “@claude” literal e isolado. É mais restrito do que os identificadores que a adição rápida reconhece quando você atribui uma tarefa nova a um agente (lá, @agent, @claude, @chatgpt e alguns outros significam “atribuir isto a um agente de IA”). Para acionar uma tarefa que já existe, só @claude em um comentário funciona. E o comentário de um agente nunca aciona o próprio agente: se ele escrever “@claude”, nada é criado.

O que “entregue” significa de fato

Entregue significa uma coisa específica: a conexão autenticada do próprio agente com o fluxo de eventos ao vivo do Done estava aberta naquele exato momento. Uma pessoa olhando a mesma tarefa em uma aba do navegador não conta. Só uma credencial autenticada como agente, conectada naquele instante, consome a entrega de um gatilho. É uma definição rígida de propósito, porque “entregue” afirma o que realmente aconteceu, não o que deveria ter acontecido.

Quando não há nada conectado: na fila, não perdido

Um gatilho não expira só porque ninguém o recebeu. Ele fica aberto até que um agente o assuma e tem prioridade sobre a ordem normal da fila. Um agente que chama list_triggers vê todos os pedidos abertos endereçados a ele (quem pediu, quando, qual tarefa e a instrução) antes do que next_task lhe entregaria de qualquer forma. claim_trigger pega um deles de forma atômica. Se dois agentes verificarem quase ao mesmo tempo, só um acaba trabalhando naquele pedido.

Como acordar um agente que não está em execução

Tanto list_triggers quanto o fluxo de eventos ao vivo pressupõem que algo esteja conectado, pelo menos de vez em quando. Se não houver nada, porque nenhum cron rodou ainda e nenhuma sessão está aberta, o Done pode notificar uma URL que você cadastrar. É um webhook de saída, disparado no momento em que o gatilho é criado, que outro processo (um pequeno serviço sempre ativo, uma função serverless, o que quer que inicie o seu agente) pode usar para dar início a uma execução. Ele é disparado junto com o aviso pelo fluxo ao vivo, nunca no lugar dele, então um agente já conectado não é afetado de nenhuma forma.

• Cadastrar a URL é uma ação humana dentro do Done, não algo que um token MCP possa fazer. É proposital: um agente capaz de apontar o Done para uma URL escolhida por ele teria dado a si mesmo um canal de saída para fora do próprio sandbox.
• O payload leva apenas ids: um nome de evento, o id da tarefa e o id do espaço de trabalho. Sem título, sem notas, sem o texto da instrução. Uma URL de webhook vazada, ou uma entrega que chega ao host errado, só revela que um id de tarefa existe. O agente que recebe ainda precisa buscar o conteúdo real por conta própria, com o próprio token MCP com escopo, passando pelas mesmas verificações de acesso de qualquer outra leitura.
• Toda entrega é assinada com HMAC-SHA256 sobre o timestamp e o corpo juntos, enviada nos cabeçalhos X-Done-Signature e X-Done-Timestamp. Assim, quem recebe pode confirmar que ela veio mesmo do Done e rejeitar qualquer repetição de uma entrega antiga.
• A URL precisa ser https, e o Done se recusa a cadastrar uma que aponte para um endereço privado ou de loopback.
• As entregas têm um limite de 60 por hora por conta, com tempo limite de 5 segundos. Um gatilho foi pensado para uma pessoa apertando um botão ou um @claude ocasional, não para uma enxurrada de eventos.

Como configurar o webhook

Cadastre uma URL uma única vez dentro do Done, e ele devolve um segredo de assinatura apenas naquele momento, sem nenhuma forma de recuperá-lo depois. Copie antes de sair da página. Para conferir uma entrega, o seu receptor calcula o HMAC-SHA256 usando esse segredo como chave sobre o valor de X-Done-Timestamp, um ponto e o corpo bruto, e compara o resultado em hexadecimal com X-Done-Signature. Trocar a URL gera um novo segredo, o que também serve como revogação: aponte para outro lugar, ou simplesmente deixe de confiar no segredo antigo, sem uma etapa separada para revogar.

O que isso não muda

O Done continua sendo uma fila que o agente precisa consultar, nunca um agendador que sai executando as ferramentas de um agente por conta própria. Nada disso faz uma chamada MCP em seu nome. O que ele resolve é mais específico: colocar um pedido na frente de um agente conectado na hora, em vez de na próxima consulta dele, e dar a algo um jeito de acordar um agente quando ninguém está consultando. Assumir a tarefa, fazer o trabalho e informar o resultado continua sendo inteiramente a sessão do próprio agente, exatamente como em qualquer outra tarefa.