Ao vivo 18/11 · Turma 318 nov às 19:00 MSK — aula prática gratuita de agentes de IA · Turma 3 ao vivo começa 23/11Aula 18/11 →Turma 3 (23/11)
LançamentoAnálise · No radarHabr AI→ original

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
O agente terminou, mas o Telegram caiu: uma fila de entrega no agent-hub, escrito em Rust
Fonte: Habr AI. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalHabr AI ↗
Editor-chefe
Dado-chave #1A resposta fica em um arquivo, previamente dividida em partes com controle de progresso
Dado-chave #2A pausa entre tentativas cresce de 5 para 600 segundos
Dado-chave #3Duplicatas são possíveis, por isso cada parte traz o ID do turno e um número

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.

História

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.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Unified AI Workspace · Nomad

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.

Try Nomad AI →Launch Nomad Agent
O que você acha?
Carregando comentários…