Hermes Agent não responde

Um teste que reduz o problema pela metade

Abra o painel do Hermes e peça ao agente algo trivial que não precise de ferramentas. O que acontece em seguida divide as cinco causas em dois grupos e evita que você depure a metade errada.

• Você recebe uma resposta. A instância está rodando e o provedor do modelo aceita as requisições. O problema está na chamada de ferramentas ou em algo na tarefa específica, não na configuração.
• Você recebe um erro. O provedor está rejeitando você: chave inválida, saldo zerado, limite de taxa ou nome de modelo descontinuado.
• Nada acontece, ou a página não carrega. Ou a instância está fora do ar, ou sua rota até ela está. São falhas diferentes, com correções diferentes, abordadas abaixo.

A instância está realmente rodando?

Verifique a instância no seu painel da Flux em vez de julgar pela interface do agente, porque um contêiner preso em loop de reinicialização parece vivo de forma intermitente. As causas comuns são memória e uma tarefa longa que nunca terminou.

A memória é o primeiro item a verificar se você foi além do uso leve. O plano de 4 GB é confortável para um agente pessoal com trabalhos agendados e avulsos, mas são as execuções simultâneas que consomem RAM: várias tarefas ao mesmo tempo, uma pesquisa longa com várias etapas que mantém um grande conjunto de dados em uso, ou uma tarefa que baixa e processa arquivos. Se o seu uso mudou de perfil e o agente começou a travar, é o plano de 8 GB dizendo que ele é necessário, e não um defeito.

Um padrão relacionado é um agente que trava em vez de falhar. Um loop de agente esperando uma ferramenta que nunca responde, por exemplo uma chamada de rede para um serviço fora do ar, fica parado indefinidamente e parece idêntico a um agente morto. Reiniciar a instância resolve, e o histórico de execuções normalmente mostra em qual etapa ele parou.

A chave do provedor, o saldo e o nome do modelo

O Hermes usa chave própria, então o silêncio mais comum tem origem no seu provedor de IA, e não no agente. Quatro falhas produzem o mesmo sintoma, e todas as quatro são corrigidas do lado do provedor:

Cole a chave novamente em vez de apenas olhar e decidir que parece correta. Um espaço no final passa numa checagem visual e faz todas as requisições falharem.

Os limites de taxa afetam os agentes mais do que os chatbots

Esta seção merece um título próprio porque agentes são especialmente bons em atingir limites. Um assistente de chat faz uma requisição por mensagem humana. Um agente faz uma requisição por etapa do seu loop de raciocínio, e uma tarefa de várias etapas pode gerar dezenas de chamadas em um minuto sem que você faça absolutamente nada.

O OpenRouter é uma escolha comum para o Hermes, e o plano gratuito deixa o efeito concreto. As variantes gratuitas de modelo, cujo identificador termina em :free, são limitadas a 20 requisições por minuto, e a cota diária é de 50 requisições se você comprou menos de $10 em créditos ao longo da vida da conta, subindo para 1000 por dia quando você comprar. Um agente trabalhando em uma tarefa de pesquisa pode esgotar 50 requisições diárias em uma única execução, momento em que para no meio da tarefa sem uma explicação óbvia.

Se seu agente completa tarefas curtas, mas sempre falha nas longas, quase certamente é por isso. A solução é uma variante paga do modelo ou aceitar o limite e manter as tarefas pequenas. Uma recarga única eleva o piso diário, mas não aumenta o limite por minuto, então um loop muito falante ainda pode atingir 20 por minuto, independentemente do quanto você já gastou.

O agente conversa, mas nunca age

Esta é a falha que as pessoas raramente diagnosticam corretamente, porque nada gera erro. O agente responde com fluência, descreve o que vai fazer e simplesmente não faz. Nenhuma ferramenta roda, nenhum arquivo aparece, nada acontece fora da conversa.

A causa é o modelo. Um agente funciona pedindo ao modelo que emita uma chamada de ferramenta estruturada, e nem todo modelo suporta isso. Se você apontar o Hermes para um modelo sem chamada de ferramentas, terá um parceiro de conversa competente que perdeu discretamente a capacidade de agir. Ele não está quebrado; não tem mãos.

Confirme que o modelo escolhido lista chamada de ferramentas ou de funções entre suas capacidades, e prefira um modelo que o provedor documente explicitamente para uso em agentes. É também por isso que o modelo mais barato disponível costuma ser uma falsa economia para um agente: a capacidade de seguir um protocolo de chamada de ferramentas de forma confiável importa muito mais do que o preço bruto por token, quando o ponto central é que o agente execute.

Uma versão mais sutil do mesmo problema é um modelo que oferece suporte a chamadas de ferramentas, mas as faz de forma pouco confiável, produzindo chamadas malformadas que falham silenciosamente e são repetidas. Se seu agente funciona pela metade e o histórico de execuções está cheio de tentativas repetidas da mesma etapa, experimente um modelo mais forte antes de presumir que o problema está na tarefa.

Quando o agente está bem, mas você não consegue acessá-lo

O Hermes vem com uma malha do Tailscale para que o agente acesse a sua rede privada, e muita gente usa essa mesma malha para chegar ao painel. Isso cria um modo de falha em que o agente está perfeitamente saudável, suas tarefas agendadas continuam rodando, e você simplesmente não tem uma rota até ele.

Chaves de autenticação expiram, e as chaves de dispositivo também expiram, então uma instância que ficou parada por meses pode sair da tailnet sem que nada tenha dado errado. Verifique o console de administração do Tailscale: se o dispositivo estiver ausente ou não autorizado, gere uma nova chave de autenticação e reconecte. O indício dessa causa é que as tarefas agendadas continuaram rodando enquanto o painel estava inacessível.

Vale conhecer também a imagem espelhada. Se o agente consegue acessar o painel mas não seus serviços internos, a malha está funcionando para você e não para ele, o que normalmente significa que o dispositivo perdeu a autorização, e não que os serviços mudaram de lugar.

A lista de verificação

1. Faça uma pergunta simples ao agente no painel. Uma resposta libera a instância e o provedor de uma só vez.
2. Verifique a instância no seu painel da Flux para ver se há um loop de reinicialização, e verifique a RAM se sua carga de trabalho ficou mais pesada.
3. Verifique o painel do provedor para ver se há uma chave inválida, saldo zerado, limite de taxa ou nome de modelo descontinuado.
4. Se tarefas longas falham e as curtas dão certo, presuma um limite de taxa e verifique sua cota diária antes de qualquer outra coisa.
5. Se o agente conversa mas nunca executa ações, confirme se o modelo selecionado oferece suporte a chamadas de ferramentas.
6. Se o painel estiver inacessível, mas as tarefas agendadas continuaram rodando, verifique no Tailscale se há um dispositivo ou uma chave de autenticação expirada.

Quase todos os casos caem na etapa um, três ou cinco. Um agente tem mais pontos de falha que um assistente de chat porque faz mais coisas, e cada um deixa uma marca diferente.