Hermes Agent Lab

Blog do Hermes Agent — Guias Práticos e Insights

Últimos artigos e insights.

skills.create_dir: faça novas skills aterrissarem onde sua config manda — não onde o prompt é ignorado

Dizer ao seu agente “crie skills em /opt/brain/skills” num prompt é uma sugestão; a tool skill_manage grava em ~/.hermes/skills/ e nenhum system prompt vence um caminho de arquivo. A nova chave de config skills.create_dir (PR #100377, mesclado em 1º de setembro) roteia skills criadas pelo agente para qualquer diretório — e toda string de instrução, schema de tool e doc que nomeia o caminho de criação renderiza dinamicamente o diretório que você configurou, então config, tool e prompt finalmente concordam.

Seus cron jobs morreram em silêncio? Um único comando faz um checkup em toda a frota

Seus jobs agendados podem estar mortos em silêncio há dias sem você saber: cron list e cron status parecem ambos “normais”. O novo comando hermes cron doctor verifica cada job em uma única passada: execuções com falha, entregas com falha, next_run_at atrasado, scripts ausentes e workdirs mortos, retornando 1 quando algo precisa de ação. Mesclado em 31 de agosto (PR #99479), atualmente apenas na main.

Cron multi-perfil finalmente acaba com a interferência cruzada: cada perfil entrega pelo seu próprio bot

Se você roda o Hermes com vários perfis, talvez já tenha visto: o resultado de cron do perfil B chega pelo bot do perfil A — ou falha com “Bot not in chat”. Uma correção mesclada em 31 de agosto (PR #99375) faz a identidade de entrega seguir o perfil dono do job: cada perfil envia pelo seu próprio bot, com suas próprias credenciais e seu próprio home chat, e o hermes -p X cron status para de mentir.

Barra de status atualizada: taxa de cache-hit, latência e tokens/s de relance

A barra de status da CLI do Hermes ganhou três novas métricas: taxa de acerto do prompt-cache (◎), latência média móvel (◷) e tokens de saída por segundo (↑) — e cada campo pode ser ativado ou desativado via display.status_bar.fields. A taxa de cache-hit é uma linha direta para a sua conta de API: mais acertos, custo muito menor. Mesclado em 30 de agosto (PR #98250), atualmente apenas na main.

“Session Not Found”? O state.db agora detecta, quarenteniza e se cura sozinho

O Hermes armazena todo o histórico de sessões no state.db. No passado, quando o banco era corrompido, você só via um desconcertante “session not found” — e o sistema continuava escrevendo no banco quebrado, piorando o estrago. Um lote de correções mesclado em 30-31 de agosto (PR #99513 e irmãos) ensina o Hermes a lidar com corrupção de forma adequada: detectá-la, quarentenizar o arquivo ruim, curar o que pode ser curado e falhar em alto e bom som em vez de fingir que está tudo bem.

Pesquise todos os comandos e skills do Hermes no Telegram: o seletor inline @botname contorna o limite de 60 slots do menu

O Telegram impõe um limite rígido ao menu de comandos / (100 por escopo, payload de ~4KB; o Hermes usa 60 slots por padrão), então os comandos de skills ficam de fora quando você instala muitas. Um recurso mesclado em 30 de agosto contorna esse limite por completo: digite @nome-do-seu-bot + uma palavra-chave em qualquer chat e obtenha um seletor ao vivo e pesquisável com todos os comandos e skills instalados — calculado a cada tecla, paginado de 50 em 50, e um toque envia o comando para o chat.

Chega de esperas de 5 minutos por aprovação no Hermes não supervisionado: a nova chave approvals.unattended_mode

Sessões de webhook, msgraph_webhook e api_server costumavam travar por todo o timeout de aprovação de 60-300s ao encontrar um comando perigoso — porque não existe nenhum humano para responder /approve nessas superfícies. Uma correção mesclada em 30 de agosto adiciona approvals.unattended_mode (padrão: deny) para que essas sessões falhem na hora, com um motivo claro, em vez de travar; além de single_query_mode para sessões one-shot de hermes chat -q.

Sessões de longa duração finalmente se atualizam: a compaction agora sempre reconstrói o system prompt

O Hermes costumava restaurar o system prompt de uma sessão de longa duração byte por byte a partir do snapshot a cada compaction — então melhorias de orientação, novos blocos de prompt e renomes de tools nunca chegavam a uma sessão que rodava há meses. Uma mudança mesclada em 30 de agosto (PR #98426) faz o commit da compaction sempre rodar o builder de prompt ao vivo: saída byte a byte idêntica mantém o objeto original (prefix caches intactos); saída divergente vence e registra o diff.

Compressão de contexto 5x mais rápida: uma requisição auxiliar em vez de 19

A lean compaction antiga chamava o modelo auxiliar uma vez por bloco de histórico para construir digests — até 28 chamadas sequenciais numa sessão grande, transformando a compaction em travadas de 7 a 11 minutos em rotas auxiliares lentas. Uma mudança mesclada em 30 de agosto (PR #98628) elimina o loop de digests: uma requisição auxiliar por tentativa de compaction. Medido numa transcrição real de 500K tokens: de 196,5s para 39,6s, e ~11K tokens a menos depois da compaction.

Dê ao Hermes uma máquina do tempo: pesquise a web como ela era com o BackSearch

Você pede a um LLM que preveja as manchetes do próximo mês — e ele leu sorrateiramente as de hoje: a previsão fica contaminada por informação posterior. O BackSearch (da General Reasoning) congela o arquivo de notícias: cada requisição carrega uma data as_of, a busca só retorna documentos rastreados até essa data, e mesma consulta + mesma data = sempre os mesmos resultados. O plugin oficial autônomo hermes-plugin-backsearch (v1.0.0, anunciado em 29 de agosto) dá ao Hermes duas ferramentas — backsearch e backfetch — controladas por OPENREWARD_API_KEY, com pegada zero sem a chave. Este artigo cobre o conceito, a instalação, a referência de parâmetros e os usos para backtests de previsão sem vazamento.

Três novos providers de modelo: Ramp Router, Nebius Token Factory e Tencent TokenPlan

Em 29 de agosto, o Hermes mesclou três novos providers de modelo: Ramp Router (router.com) — um único endpoint compatível com OpenAI Responses que roteia para muitos upstreams com fallbacks no servidor e controles de gasto; Nebius Token Factory — inferência pay-as-you-go da Nebius; e Tencent TokenPlan — a assinatura token-plan do Tencent Cloud Hunyuan num endpoint compatível com Anthropic, que também traz o modelo hy4-preview para o catálogo oficial. As PRs #97915/#97916/#97917 estão na main, ainda sem release.

Três novas skills opcionais oficiais: questionários de decisão, wizards de setup e uma sabatina de planos

Em 29 de agosto, o Hermes lançou três novas skills opcionais de uma vez: decision-questionnaire transforma uma decisão que só uma pessoa pode tomar em um questionário assíncrono, setup-wizard-generator produz wizards bash interativos para etapas de setup que só humanos fazem, e grill-me v2.0.0 sobe para entrevistas em frontier rounds que interrogam cada premissa não examinada do seu plano. As três são ports nativos do Hermes do repositório mattpocock/skills (240 mil estrelas), instaláveis com um único hermes skills install.

Listas de tarefas agora aninham: o todo do Hermes ganha subtarefas

Quando você entrega uma tarefa complexa ao Hermes, ele mantém uma lista de tarefas (todo) na sessão para acompanhar o próprio progresso. Essa lista costumava ser plana — "empacotar a release" e "garantir que os testes passem" só podiam ficar lado a lado. A PR #97921 (mesclada em 29 de agosto) adiciona um campo parent aos itens de todo: as tarefas podem se aninhar em árvores, as superfícies renderizam a indentação automaticamente e o recurso inteiro custa apenas ~45 tokens no schema de tool em cache.

Precisa perguntar algo no meio da tarefa? O /btw responde na hora, sem interromper nada

Antes, quando surgia uma dúvida durante uma execução, sobravam duas opções ruins: interromper o agente ou abrir uma sessão nova que não sabe nada da conversa. A PR #97937/#97974 (mesclada em 29 de agosto) transforma o /btw em um comando real de pergunta paralela: ele responde a partir da conversa atual, com contexto completo, pelo preço de leitura de cache — sem interrupção, sem poluição, sem gasto extra. O /background se aposenta na mesma mudança; o /bg vira o comando canônico de tarefas em segundo plano.

Um único comando abre uma sessão inteira: hermes chat -q agora permanece interativo em um TTY

hermes chat -q "pergunta" costumava responder uma vez e sair; ter uma sessão interativa exigia rodar o comando, salvar o arquivo de sessão e depois retomar — uma dança clunky de dois passos. A mudança mesclada em 28 de agosto (PR #97121) faz o -q semear uma sessão interativa ao vivo em um TTY real, com a primeira mensagem enviada literalmente — nunca interpretada como comando slash ou escape de shell.

O Hermes para de adivinhar o tamanho do seu contexto: ancoragem de usage alinha os limiares de compressão com números reais

O Hermes costumava reestimar a contagem de tokens da conversa inteira a cada turno com heurísticas (chars/4, imagens fixas de 1500 tokens), acumulando erro conforme o histórico crescia — causando compressões surpresa e erros 413 de payload muito grande. A mudança mesclada em 28 de agosto (PR #97206) ancora a contabilização de contexto no usage reportado pelo provider, encolhendo a janela de estimativa do transcript inteiro para um único turno.