O agente terminou, mas o Telegram caiu: uma fila de entrega no agent-hub, escrito em Rust
Quando o agente já terminou o trabalho, mas o Telegram está indisponível, não dá para repetir a requisição ao modelo: isso custa tokens e pode alterar arquivos novamente. O autor do agent-hub, escrito em Rust, separou a obtenção do resultado da sua entrega. O texto final é gravado primeiro em disco, e uma tarefa separada o envia em partes e tenta de novo após uma falha ou reinicialização.
Processado por IA de Habr AI; editado por Hamidun News
Uma situação conhecida: o agente leu o código, corrigiu os arquivos, verificou o resultado e escreveu uma resposta excelente. E nesse momento o Telegram está indisponível. Para o agente, o trabalho acabou; para o usuário, nada aconteceu. Rodar a tarefa de novo não é atraente: custa tempo, tokens e há o risco de o agente mudar algo outra vez. Foi exatamente isso que enfrentou o autor do agent-hub, um aplicativo em Rust que executa agentes de IA localmente e se comunica com eles por meio de tópicos de um grupo do Telegram.
Separar o resultado da entrega
A ideia central é simples: receber a resposta e enviá-la são dois eventos distintos. Quando o turno do agente termina com sucesso, o hub primeiro salva o texto final no arquivo local topics.results.json e o coloca na fila, e só depois acessa o Telegram. Uma tarefa separada cuida do envio e das novas tentativas. Após uma reinicialização, ela lê o estado do disco e continua a entrega sem nova chamada ao modelo.
Na fila entra não toda a conversa, mas os blocos de texto consecutivos após a última chamada de ferramenta exibida. Anexos, mensagens intermediárias, perguntas e botões de permissão não são repetidos automaticamente.
Um detalhe importante: o hub armazena as partes já preparadas, e não o Markdown original. Se, após uma atualização do aplicativo, a conversão da marcação mudar, os limites das mensagens permanecem os mesmos, e o número salvo da próxima parte não vai deslizar para outro trecho de texto.
Como sobrevive a falhas
O ciclo é este: encontrar um registro pronto, reservá-lo por 60 segundos e salvar isso em disco, enviar a parte atual, gravar a confirmação e passar para a próxima. A reserva é necessária caso o processo seja interrompido no meio de uma requisição de rede: o registro não ficará ocupado para sempre. A requisição ao Telegram é limitada a 20 segundos, e o envio ocorre a no máximo uma parte por segundo.
Em caso de erro temporário, as pausas crescem: 5, 15, 30, 60, 120, 300, 600 segundos. Após oito falhas seguidas, a entrega para até uma nova tentativa manual. Se o próprio Telegram pedir para esperar (RetryAfter), essa pausa é armazenada para a fila de todo o grupo e não é reduzida nem por tentativa manual nem por reinicialização. Se o Telegram rejeitar o HTML, o hub tenta enviar texto simples, e se isso também falhar, aguarda a intervenção de uma pessoa.
A fila pode ser gerenciada a partir do tópico: /last mostra a última resposta salva sem chamar o modelo, /outbox mostra as entregas pendentes com os botões «Repetir» e «Excluir». Se a leitura do armazenamento falhar, a interface mostra «desconhecido» em vez de zero, para que uma falha de disco não pareça uma fila vazia.
Onde as garantias terminam
O autor, com honestidade, não promete entrega exatamente uma vez. O Telegram pode ter aceitado a mensagem e a confirmação se perdido; ou o hub não conseguiu gravá-la em disco antes de parar. Nesse caso, a parte será enviada de novo. Por isso, no início de cada parte há o ID do turno e um número como «parte 2/3»: o rótulo não elimina a duplicata, mas mostra que se trata de uma repetição, e não de uma nova resposta.
Há também limites rígidos: até 50 respostas pendentes e 8 MiB na fila, retenção de até 7 dias, até 64 KiB por texto. Se a fila estiver cheia, registros antigos não são removidos, e a nova resposta é enviada sem nova tentativa automática e com um aviso. O arquivo é criado com permissões 0600, mas contém as respostas do agente, então vale lembrar dos backups.
Os testes rodaram em Linux com Telegram simulado e armazenamento temporário: rede indisponível, reinicialização após envio parcial, perda da confirmação, RetryAfter, erro de HTML, estouro, troca de grupo. Queda de energia não foi simulada.
O que levar daqui
O padrão é universal para qualquer ferramenta de agentes: salve o resultado antes da entrega, guarde o progresso por partes, dê identificadores às novas tentativas e não prometa exactly-once onde ele não existe. É, na essência, um pequeno padrão outbox, conhecido do backend, mas para agentes, nos quais reexecutar é caro e inseguro. O código é aberto sob licença MIT.
- 12 de nov. de 2026Claude in Chrome exige autorização para cada clique em sites da categoria 3
- 12 de nov. de 2026Norwest capta fundo recorde de US$ 4 bilhões e aposta em agentes, voz e IA física
- 12 de nov. de 2026AWS mostra como 100% de precisão na busca escondem a falha de um agente de IA
- 12 de nov. de 2026A Garage Eight eliminou aprovações externas em 69 MRs de um serviço interno com revisão por IA
Perguntas frequentes sobre a notícia
O que se sabe sobre Separar o resultado da entrega?
A ideia central é simples: receber a resposta e enviá-la são dois eventos distintos. Quando o turno do agente termina com sucesso, o hub primeiro salva o texto final no arquivo local topics.results.json e o coloca na fila, e só depois acessa o Telegram. Uma tarefa separada cuida do envio e das novas tentativas. Após uma reinicialização, ela lê o estado do disco e continua a entrega sem nova chamada ao modelo.
Como sobrevive a falhas?
O ciclo é este: encontrar um registro pronto, reservá-lo por 60 segundos e salvar isso em disco, enviar a parte atual, gravar a confirmação e passar para a próxima. A reserva é necessária caso o processo seja interrompido no meio de uma requisição de rede: o registro não ficará ocupado para sempre. A requisição ao Telegram é limitada a 20 segundos, e o envio ocorre a no máximo uma parte por segundo. Em caso de erro temporário, as pausas crescem: 5, 15, 30, 60, 120, 300, 600 segundos.
Onde as garantias terminam?
O autor, com honestidade, não promete entrega exatamente uma vez. O Telegram pode ter aceitado a mensagem e a confirmação se perdido; ou o hub não conseguiu gravá-la em disco antes de parar. Nesse caso, a parte será enviada de novo. Por isso, no início de cada parte há o ID do turno e um número como «parte 2/3»: o rótulo não elimina a duplicata, mas mostra que se trata de uma repetição, e não de uma nova resposta.
Test Frontier LLMs & Autonomous Agents in One Workspace
Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.
O essencial da IA — uma vez por semana
Sete histórias que realmente importaram, escolhidas a dedo. Sem ruído nem releases.
Pronto! Verifique seu e-mail para a confirmação.