GUIA COMPLETO do Hermes Agent: Arquitetura, Configuração e o Loop de Autoaperfeiçoamento

@ScottyBeamIO
INGLÊShá 1 mês · 16/06/2026
253K
486
58
30
1.3K

TL;DR

O Hermes é um agente de IA residente na nuvem que aprende continuamente ao extrair padrões de conversas para aprimorar suas próprias habilidades. Este guia cobre tudo, desde a instalação e roteamento de modelos até seu sofisticado sistema de curadoria em segundo plano.

Está surgindo uma nova categoria de ferramentas de IA silenciosamente: agentes que não vivem em uma janela de chat que você abre e fecha, mas que rodam continuamente na nuvem e conversam com você através de um mensageiro, como um colega de trabalho que nunca sai do ar.

O Hermes é uma das implementações mais interessantes dessa ideia, e o que o diferencia de agentes comparáveis como o OpenClaw é um ciclo de autoaperfeiçoamento integrado – um sistema que observa suas conversas, extrai padrões úteis delas e transforma esses padrões em atualizações permanentes para sua própria memória e conjunto de habilidades.

Este artigo explica como o Hermes é montado, como configurá-lo e como esse ciclo de autoaperfeiçoamento realmente funciona nos bastidores.

O que é o Hermes e como ele difere do OpenClaw

Hermes é um agente de IA residente na nuvem, estruturalmente similar ao OpenClaw: ele funciona 24 horas por dia, 7 dias por semana, e você interage com ele através de um aplicativo de mensagens, em vez de um terminal ou aba do navegador.

As diferenças significativas são três.

Primeiro, o Hermes já vem com uma biblioteca muito maior de habilidades integradas prontas para uso, então você gasta menos tempo configurando integrações por conta própria.

Segundo, o processo de configuração é consideravelmente mais simplificado – uma TUI guiada cuida de quase tudo.

Terceiro, e mais importante, o Hermes é projetado em torno do autoaperfeiçoamento contínuo: ele não apenas executa tarefas, mas acumula conhecimento processual sobre como executá-las melhor ao longo do tempo.

Instalação e Configuração Inicial

Colocar o Hermes em funcionamento requer um único comando.

No Windows, execute isto no PowerShell:

iex (irm

https://hermes-agent.nousresearch.com/install.ps1

No Linux, macOS ou WSL, o equivalente é:

curl -fsSL

https://hermes-agent.nousresearch.com/install.sh | bash

Após a instalação, reiniciar o terminal e executar hermes setup inicia um fluxo de configuração guiada que percorre a seleção de modelo, backend do terminal, gateway de mensagens e configuração de ferramentas em sequência.

SCOTTY BEAM - inline image

Escolhendo e Roteando Modelos

SCOTTY BEAM - inline image

A primeira decisão real na configuração é qual provedor de LLM alimenta o "cérebro" do agente. A autenticação ocorre via OAuth em vez de chaves de API brutas, o que permite fazer login através de uma sessão existente do Claude Code ou Codex CLI, em vez de gerar uma chave de API separada.

O que é genuinamente bem projetado aqui é como o Hermes separa o modelo usado para sua conversa principal dos modelos usados para tarefas em segundo plano e auxiliares. Por padrão, o mesmo modelo lida com ambas, mas cada tarefa auxiliar pode ser direcionada a um provedor diferente de forma independente.

As tarefas que suportam esse tipo de substituição são:

  • vision – análise e descrição de imagens
  • web_extract – resumir páginas da web longas
  • compression – comprimir um contexto de conversa que está transbordando
  • title_generation – gerar títulos de sessão
  • curator – o agente em segundo plano responsável pelo ciclo de autoaperfeiçoamento
  • kanban_decomposer – dividir tarefas grandes em subtarefas no modo Kanban
  • goal_judge – o agente que verifica se um /goal foi realmente alcançado

Isso é configurado diretamente no config.yaml, por exemplo:

yaml
1# Primary model for chat and complex reasoning
2model:
3 provider: "anthropic"
4 default: "claude-4-8-sonnet"
5 auxiliary:
6 vision:
7 provider: "gemini"
8 model: "gemini-2.5-flash"
9 compression:
10 provider: "custom"
11 base_url: "http://localhost:11434/v1"
12 api_key: "none"
13 model: "qwen2.5:32b"

Este tipo de roteamento explícito resolve um problema real com o OpenRouter como escolha padrão: o mesmo modelo nominal é frequentemente implantado por muitos provedores diferentes, frequentemente em quantizações diferentes, e o OpenRouter irá silenciosamente embaralhar cada nova requisição entre cerca de vinte deles.

O efeito prático é que, dentro de uma única sessão, você não está conversando com um modelo consistente – você está conversando com um elenco rotativo de instâncias dele configuradas de forma diferente, algumas das quais lidam com chamadas de ferramentas e templates de prompt de forma mais confiável do que outras. Roteando manualmente dentro do Hermes, isso é evitado completamente.

SCOTTY BEAM - inline image

Vale notar também que, se você quiser economizar dinheiro no modelo conversacional sem sacrificar a qualidade da codificação, o Hermes suporta comandos /claude_code e /codex que delegam tarefas de codificação diretamente a essas ferramentas de CLI, em vez de lidar com elas com o modelo de chat configurado.

SCOTTY BEAM - inline image

Backends de Terminal

SCOTTY BEAM - inline image

Uma peça central da arquitetura é o Ambiente de Backend do Terminal, que determina onde e como os comandos do shell e scripts Python realmente executam, e como o agente interage com seu sistema de arquivos. O Hermes suporta cinco.

Local é o padrão. Os comandos são executados diretamente em sua máquina com as mesmas permissões da sua conta de usuário – sem isolamento. É a escolha certa para desenvolvimento local e uso pessoal confiável, onde você quer que o agente edite seus arquivos de projeto reais.

A segurança aqui depende inteiramente de um sistema de aprovações integrado que intercepta comandos destrutivos (um rm -rf /, um DROP TABLE) e pede permissão explícita antes de executá-los.

Docker executa o agente dentro de uma sandbox isolada, para que ele não possa tocar no seu sistema host. SSH faz com que o agente execute comandos e trabalhe com arquivos em um servidor remoto através de uma conexão remota. Modal executa tudo em sandboxes de nuvem sem servidor – você está essencialmente alugando computação por segundo, pagando apenas pelos segundos reais em que seu código é executado.

Daytona é uma camada de gerenciamento de contêineres construída especificamente para agentes de codificação de IA; é mais rápido do que executar o Docker diretamente e lida com a configuração do ambiente e instalação de dependências automaticamente.

Para a maioria dos casos de uso pessoal, Local é genuinamente suficiente – as outras opções importam principalmente se você estiver executando código não confiável ou operando em escala de equipe.

Gateway de Mensagens e Configuração de Ferramentas

SCOTTY BEAM - inline image

Após o backend do terminal, a configuração avança para escolher onde você realmente conversará com o agente – sendo o Telegram a opção mais polida. Selecioná-lo fornece um link direto que cria um bot pré-configurado; não há configuração manual de token de bot envolvida.

SCOTTY BEAM - inline image
SCOTTY BEAM - inline image
SCOTTY BEAM - inline image

O restante da configuração orienta a ativação de ferramentas individuais e seus respectivos provedores – automação de navegador, geração de imagens, texto-para-fala e pesquisa na web. Para pesquisa na web especificamente, Firecrawl auto-hospedado ou Exa se destacam como escolhas fortes para raspagem e recuperação orientadas a agentes.

SCOTTY BEAM - inline image
SCOTTY BEAM - inline image
SCOTTY BEAM - inline image
SCOTTY BEAM - inline image

A pesquisa no X requer uma assinatura Grok para ser ativada, o que é bom saber antes de procurá-la no menu.

SCOTTY BEAM - inline image

Comandos de barra que valem a pena conhecer

O Hermes vem com uma longa lista de comandos de barra, a maioria autoexplicativa pelo nome, mas alguns merecem ser mencionados especificamente.

  1. /background <prompt> executa uma tarefa em segundo plano sem interromper sua sessão principal.
  2. /goal define um objetivo de longo prazo para o qual o agente trabalha persistentemente, com subcomandos para pausar, retomar, limpar ou verificar o status;
  3. /subgoal gerencia objetivos menores aninhados sob uma meta ativa.
  4. /kanban orquestra trabalho assíncrono de longa duração em vários agentes independentes – funcionando como um quadro Kanban real, onde um conjunto de tarefas é distribuído entre agentes de trabalho e passa por "a fazer", "em andamento" e "concluído" à medida que é transferido entre eles.

No lado do desenvolvimento, /github_pr_workflow lida com todo o ciclo de branch para merge, incluindo CI, /github_code_review revisa pull requests, e /codebase_inspection analisa a divisão de linguagens e contagens de linhas de um repositório. /dogfood é um modo de QA dedicado que caça bugs em um aplicativo web e produz um relatório baseado em evidências. /spike executa um experimento rápido e descartável para validar uma ideia antes de se comprometer com o desenvolvimento completo, e /systematic_debugging resolve bugs em quatro fases, entendendo a causa raiz antes de tentar uma correção.

Há também um conjunto de comandos específicos de integração – /notion, /obsidian, /airtable, /google_workspace, /arxiv, /blogwatcher, /polymarket, /ocr_and_documents, /youtube_content – cada um encapsulando um serviço externo ou fluxo de trabalho específico, além de /bundles, que agrupa várias habilidades existentes sob um único comando de barra por meio de pequenos arquivos de configuração YAML.

Tarefas Cron e Webhooks

Duas primitivas de automação merecem atenção particular.

  • Tarefas Cron permitem agendar um script para ser executado em um temporizador; se você passar -no-agent ao criar uma, o Hermes executará um script Python ou bash simples e apenas encaminhará sua saída para seu mensageiro, sem gastar nenhum token de LLM.
  • Webhooks são a peça mais poderosa: eles permitem que o agente reaja a eventos externos em vez de um temporizador. Você pode configurar um webhook para que, por exemplo, um novo pull request no GitHub acione automaticamente um agente com um prompt e conjunto de habilidades específicos – efetivamente colocando de prontidão um agente revisor sem intervenção manual por PR.

Motores de Contexto

O motor de contexto governa como o Hermes comprime e gerencia o histórico da conversa quando ele se aproxima do limite de tokens do modelo, e há duas opções.

  • O padrão, chamado Compressor, aplica sumarização com perdas à parte intermediária de uma conversa longa.
  • A alternativa, LCM (Gerenciamento de Contexto sem Perdas), adota uma abordagem estruturalmente diferente: em vez de produzir um resumo em texto, ele constrói um grafo acíclico direcionado dos pontos-chave da conversa, permitindo que o agente navegue de uma visão geral de alto nível e altamente comprimida até as mensagens originais específicas que a suportam.
SCOTTY BEAM - inline image

Motores de Memória

Provedores de memória externa funcionam junto com os arquivos de memória local integrados do Hermes, MEMORY.md e USER.md, adicionando capacidades como pesquisa semântica e grafos de conhecimento.

Vários podem ser configurados diretamente através da TUI de configuração.

  1. Honcho é construído em torno da modelagem de um perfil de usuário detalhado, usando chamadas LLM em segundo plano para sintetizar observações em duas camadas: uma camada base de resumos e perfis de sessão, e uma camada dialética que analisa as necessidades atuais do usuário.
  2. OpenViking é um banco de dados de contexto que constrói uma hierarquia de conhecimento no estilo de sistema de arquivos, suportando recuperação de contexto em níveis e classificando automaticamente fatos extraídos em seis categorias – eventos, padrões, preferências e assim por diante – no final de cada sessão.
  3. Mem0 é um serviço de memória em nuvem totalmente gerenciado; a extração de fatos ocorre no lado do servidor via LLM, e inclui pesquisa semântica, reclassificação de resultados e desduplicação automática, embora, por ser hospedado na nuvem, seja também a única opção aqui com um custo recorrente.
  4. Hindsight é um sistema de memória de longo prazo mais avançado, construído sobre um grafo de conhecimento, no estilo GraphRAG. Ele extrai entidades das sessões, constrói relacionamentos entre elas e preserva turnos conversacionais completos, incluindo chamadas de ferramentas, com a memória dividida em quatro categorias: fatos sobre o mundo, a própria experiência do agente, opiniões e observações.
  5. Holographic é um armazenamento de fatos local, baseado em SQLite, sem dependências externas, incluindo um sistema de pontuação de confiança para fatos armazenados e o uso de Representações Reduzidas Holográficas para suportar consultas algébricas e composicionais, com a capacidade de detectar automaticamente contradições dentro de sua base de conhecimento.
  6. RetainDB é uma API em nuvem para memória de equipe, oferecendo pesquisa híbrida entre métodos vetoriais, BM25 e reclassificação, com a memória dividida em sete tipos distintos e compressão delta para manter o armazenamento eficiente.
  7. ByteRover é um sistema de memória local portátil, acessado através de uma CLI, construindo uma árvore de conhecimento hierárquica e extraindo fatos importantes antes que a compressão com perdas tenha a chance de removê-los do contexto.
  8. Supermemory oferece memória semântica de longo prazo com uma API de grafo: ele ingere logs completos de sessão após o término de uma conversa para construir seu grafo de conhecimento, limpa periodicamente os fatos relembrados para evitar poluição das interações atuais e pode isolar a memória em contêineres separados por perfil de agente.

Para uso diário, a memória local padrão é genuinamente adequada para a maioria das pessoas – os sistemas mais pesados trocam um custo real de recursos, especialmente RAM para opções hospedadas localmente, por uma capacidade que a maioria dos fluxos de trabalho ainda não precisa.

O Ciclo de Autoaperfeiçoamento

Esta é a característica que mais distingue o Hermes de um agente convencional: um conjunto de processos assíncronos em segundo plano que analisam continuamente suas conversas, extraem padrões úteis delas e escrevem esses padrões na memória de longo prazo e na memória processual (habilidades) – e então mantêm esse conhecimento acumulado para que não se deteriore com o tempo. Todo o sistema funciona em paralelo com seu chat principal e é composto por três componentes: um sistema de gatilho, um agente de revisão em segundo plano e um curador.

  • O Sistema de Gatilho

O Hermes não analisa todas as mensagens em tempo real, pois isso queimaria tokens sem benefício. Em vez disso, ele depende de dois contadores que acionam uma passagem de reflexão quando ultrapassam um limite.

Um gatilho de memória é disparado a cada dez prompts do usuário, verificando se novos fatos dignos de serem salvos apareceram na conversa.

Um gatilho de habilidade é disparado a cada dez iterações de chamada de ferramenta dentro de um único turno, partindo do princípio de que, se o agente gastou tantas etapas lutando com um problema por tentativa e erro, essa experiência vale a pena ser analisada e possivelmente transformada em uma habilidade reutilizável.

Assim que qualquer um dos contadores atinge seu limite, uma função interna é acionada, entregando um instantâneo da conversa atual a um processo de revisão em segundo plano.

  • O Agente de Revisão em Segundo Plano

Este instantâneo vai para um processo de agente totalmente separado e isolado que é executado em paralelo sem interromper sua sessão principal. Ele funciona em duas direções.

  1. No lado declarativo, se notar novas preferências do usuário ou detalhes do ambiente – uma preferência por Supabase, um projeto fixado no Python 3.12 – ele atualiza MEMORY.md ou USER.md, dependendo de qual arquivo o fato pertence.
  2. No lado processual, se detectar que o agente acabou de resolver um problema não trivial ou elaborou um processo complexo, ele pode criar uma nova habilidade, editar uma existente, aplicar um patch direcionado ou excluir uma habilidade por completo. Qualquer habilidade que ele criar será explicitamente marcada como gerada pelo agente, para que sua origem seja sempre rastreável.

Para que o curador possa eventualmente julgar quais dessas habilidades autogeradas realmente valem a pena manter, o Hermes mantém um registro de uso oculto rastreando, para cada habilidade: quantas vezes foi carregada em um prompt, quantas vezes o agente a abriu para lê-la, quantas vezes foi editada e os carimbos de data/hora para criação, último uso e última edição.

  • O Curador

Se não for controlado, esse processo pode eventualmente produzir centenas de habilidades, algumas redundantes, outras desatualizadas.

O curador existe para evitar que essa base de conhecimento se degrade. Ele só é iniciado quando duas condições são satisfeitas simultaneamente: tempo suficiente passou desde sua última execução (sete dias, por padrão) e o agente principal está inativo há tempo suficiente (duas horas, por padrão) para que uma passagem de manutenção pesada não interfira no trabalho ativo.

Antes de fazer qualquer alteração, ele faz automaticamente um backup de todo o diretório de habilidades, para que qualquer resultado insatisfatório possa ser revertido através de um único comando no terminal.

O trabalho do curador acontece em duas fases:

  • A primeira é puramente mecânica e não envolve nenhuma chamada de LLM: ele verifica as métricas de uso, marca qualquer habilidade gerada pelo agente que não foi usada por mais de 30 dias como obsoleta e move qualquer coisa não usada por mais de 90 dias para uma pasta de arquivo morto. Habilidades importantes podem ser explicitamente fixadas para protegê-las deste processo.
  • A segunda fase é uma revisão genuína de LLM, executada através de uma instância de agente isolada separada usando qualquer modelo configurado para a tarefa auxiliar do curador – por padrão, o mesmo modelo da conversa principal, embora possa ser direcionado para algo mais barato. Vale a pena ter cuidado ao escolher algo muito barato aqui, pois a qualidade dessas decisões tem um efeito downstream real na biblioteca de habilidades.

Para cada habilidade, o curador decide mantê-la como está se ainda for precisa e útil, corrigi-la se contiver erros ou métodos desatualizados, mesclá-la com outra habilidade que cubra substancialmente o mesmo terreno (realocando corretamente quaisquer scripts, avaliações ou arquivos de referência associados e reescrevendo caminhos relativos no processo) ou arquivá-la por completo.

No final do ciclo, ele produz um relatório detalhado incluindo um mapa de renomeação mostrando exatamente como os nomes das habilidades antigas foram mapeados para os novos após quaisquer mesclagens, para que o raciocínio por trás de cada decisão seja totalmente auditável.

Usando o Hermes de forma eficaz

Agentes de nuvem como este são genuinamente valiosos para qualquer processo que você possa executar 24 horas por dia, 7 dias por semana – sendo o trabalho de codificação a exceção notável – desde que você tenha realmente digitalizado esse processo cuidadosamente e construído uma habilidade sólida em torno dele, incluindo avaliações.

O fluxo de trabalho que tende a produzir bons resultados é mais ou menos assim:

  1. Comece gravando a si mesmo, em detalhes, percorrendo o processo do início absoluto ao fim, idealmente usando uma ferramenta de ditado para capturá-lo com precisão – e esta etapa só funciona se você realmente entender o processo ou o tiver pesquisado adequadamente.
  2. Pegue essa gravação ou essas anotações e alimente-as em um agente de codificação usando uma ferramenta de criação de habilidades para produzir um primeiro rascunho; ele ainda não será bom o suficiente para ser delegado, especialmente para qualquer coisa complexa.
  3. Incorpore avaliações – soluções de referência que representam um resultado correto – pois são elas que permitem medir se a habilidade está tendo um bom desempenho, em vez de apenas adivinhar.
  4. Execute a habilidade em um ambiente de teste e refine tanto as avaliações quanto o conteúdo da habilidade com base no que você observar, fazendo a maior parte dessa edição manualmente, em vez de delegá-la.
  5. Somente quando a habilidade se comportar de forma consistente e determinística, ela deve ser delegada ao agente sempre ativo. Se o processo depender de algum serviço externo, vale a pena verificar se um servidor MCP ou CLI existente já o cobre antes de construir um do zero.

O ponto central é que a gama de coisas que você pode delegar a um agente como este é limitada principalmente pelo quão bem você consegue especificar o trabalho, não pela capacidade bruta do agente.

Três princípios parecem se manter em todos os casos de uso: não terceirize o trabalho de codificação para um agente de nuvem não supervisionado 24/7, mantenha um humano no ciclo revisando o que o agente realmente produz e trate o refinamento de habilidades como um trabalho contínuo, em vez de algo que você termina uma vez e abandona.

Se isso foi útil – salve nos favoritos. Você vai querer voltar a consultá-lo.

Para mais análises como esta, siga @ScottyBeamIO

Sem enrolação, apenas o que realmente funciona.

Guardar com um clique

Faça leitura aprofundada de artigos virais com IA no YouMind

Guarde a fonte, faça perguntas específicas, resuma o argumento e transforme um artigo viral em notas reutilizáveis num único espaço de trabalho com IA.

Explorar o YouMind
Para criadores

Transforme o seu Markdown num artigo 𝕏 impecável

Quando publica os seus próprios textos longos, formatar imagens, tabelas e blocos de código para o 𝕏 é uma dor de cabeça. O YouMind transforma um rascunho completo em Markdown num artigo 𝕏 impecável e pronto a publicar.

Experimente Markdown para 𝕏

Mais padrões para decifrar

Artigos virais recentes

Explorar mais artigos virais