Sessions: Your AI Never Forgets a Conversation
Personality & SOUL.md — Give AI a Character — easy-to-understand guide based on official docs
Sessões: Sua IA Nunca Esquece uma Conversa
Já fechou uma janela de chat e perdeu a conversa inteira? Com o Hermes Agent, isso é coisa do passado. Todas as conversas — seja pelo CLI, Telegram, Discord, Slack, WhatsApp ou qualquer outra plataforma — são salvas automaticamente como uma sessão. Pense nisso como um histórico de chat turbinado que você pode pesquisar, retomar e gerenciar.
Como as Sessões Funcionam
Por baixo dos panos, o Hermes armazena tudo em um banco de dados SQLite em ~/.hermes/state.db. Isso não é apenas um log simples — é um registro completo que inclui:
- ID da sessão e plataforma de origem (onde a conversa aconteceu)
- Um título único e legível para facilitar a identificação
- Configuração do modelo e um snapshot do prompt do sistema
- Histórico completo de mensagens (incluindo chamadas de ferramentas e resultados)
- Contagem de tokens e timestamps
- ID da sessão pai (para quando conversas longas são divididas)
A melhor parte? O banco de dados usa busca full-text FTS5, então você pode encontrar qualquer conversa passada pesquisando por palavras-chave.
O Que Realmente Entra no Contexto
Aqui vai um equívoco comum: o Hermes não reenvia cada byte do histórico a cada turno. Em vez disso, o modelo vê o prompt do sistema, a janela de conversa atual e qualquer coisa explicitamente injetada naquele turno.
Arquivos de mídia são tratados de forma inteligente:
- Imagens são analisadas uma vez (se o modelo suportar visão) ou convertidas em descrições de texto
- Áudio é transcrito para texto
- Documentos têm seu texto extraído, enquanto outros arquivos são salvos como caminhos com anotações
Então, se você pedir ao Hermes para criar um meme a partir de uma imagem, ele não vai ficar carregando aquele JPEG nos turnos seguintes. Ele apenas mantém a descrição e o resultado.
O que realmente consome contexto é texto verboso — transcrições coladas, logs completos, saídas enormes de ferramentas, diffs longos. A documentação recomenda usar resumos, caminhos de arquivo e trechos focados em vez de despejar artefatos grandes no chat.
Dicas de Profissional para Gerenciar Sessões
- Use
/compressquando uma sessão ficar longa demais - Use
/newpara iniciar um novo thread (você pode até nomeá-lo:/new payments-refactor) - Use
hermes sessions prunepara excluir sessões antigas encerradas - Use
hermes sessions optimizepara reduzir um banco de dados inchado sem apagar nada
Retomada de Sessão no CLI: Continue de Onde Parou
O CLI oferece várias maneiras de retomar conversas:
Continuar a última sessão:
hermes --continue
# ou
hermes -c
Mágica por terminal: Aqui vai um truque legal — um -c simples é sensível ao terminal. Se você tiver dois painéis de terminal lado a lado, cada um retoma sua própria conversa. Chega de brigar pela sessão “mais recente”. Isso funciona em painéis do tmux, janelas do kitty, painéis do wezterm e muito mais. Você pode desativar isso com session.terminal_continue: false na sua configuração.
Retomar por nome:
hermes -c "meu projeto"
Se você tiver várias sessões com o mesmo nome (como “meu projeto #2”, “meu projeto #3”), ele escolhe automaticamente a mais recente.
Retomar uma sessão específica:
hermes --resume 20250305_091523_a1b2c3d4
# ou por título
hermes --resume "refatorando auth"
# ou apenas a mais recente
hermes --resume latest
Origens das Sessões: Todas as Plataformas Contam
O Hermes rastreia de qual plataforma cada sessão veio. A lista é impressionante: CLI, Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost, Email, SMS, DingTalk, Feishu, WeCom, Weixin, iMessage (via BlueBubbles), QQ Bot, Home Assistant, webhooks, servidor de API, editor ACP, jobs cron e processamento em lote.
Isso significa que você pode começar uma conversa no Telegram e retomá-la pelo seu CLI — o histórico completo está bem ali.
Conclusão
As sessões transformam o Hermes de um chatbot sem estado em um assistente persistente que lembra de tudo. Seja para depurar um problema complicado, planejar uma grande refatoração ou apenas retomar a conversa de ontem, as sessões estão aí para isso. E com gerenciamento inteligente de contexto, você aproveita os benefícios da memória sem explodir seu consumo de tokens.
Da próxima vez que estiver em uma conversa longa, experimente /compress quando as coisas ficarem pesadas, ou nomeie suas sessões para encontrá-las depois. Seu eu do futuro vai agradecer.
📖 Documentação oficial
この記事は Hermes Agent のDocumentação oficialに基づいています:Documentação oficial › user-guide/features/personality