Hermes Agent: Sistema de Memória
Última atualização: 2026-08-31
O sistema de memória é o diferencial principal do Hermes — não é um chatbot "esquece após conversar", mas um assistente inteligente que lembra de tudo entre sessões.
📋 Pré-requisitos: Lição 3 — Arquivos de Configuração
1. O Que Você Vai Aprender
| # | Conteúdo |
|---|---|
| ❶ | Arquitetura de memória de três camadas |
| ❷ | Mecanismo da memória de trabalho |
| ❸ | Memória de longo prazo e recuperação semântica |
| ❹ | Modelagem de usuário Honcho |
| ❺ | Comandos de gerenciamento de memória |
2. História
(1) Problema: Reapresentando-se Toda Vez
Bob conversa com IA todo dia e sempre tem que repetir: "Sou dev frontend, uso React + TypeScript, prefiro ESLint..." A IA nunca lembra.
(2) Solução: O Agente Realmente Lembra de Você
# Dia 1
me: I'm Alice, backend developer, Python + FastAPI
Agent: ✅ Remembered! I'll keep your tech stack and preferences long-term.
# Dia 30
me: Help me write an API
Agent: [Recall] You use Python + FastAPI, prefer type hints...
Here's the FastAPI version:
```python
from fastapi import FastAPI
app = FastAPI()
```
3. Arquitetura de Memória de Três Camadas
graph TD
A[Entrada do Usuário] --> B[Memória de Trabalho]
B -->|Extração automática| C[Memória de Longo Prazo]
C -->|Modelagem profunda| D[Modelo do Usuário - Honcho]
D -->|Personalização| E[Saída de Resposta]
| Camada | Conteúdo | Tempo de Vida | Capacidade |
|---|---|---|---|
| Memória de Trabalho | Contexto e intenção da conversa atual | Sessão única | 50 entradas |
| Memória de Longo Prazo | Preferências do usuário, informações de projeto, padrões comuns | Permanente | Ilimitada |
| Modelo do Usuário | Perfil comportamental, avaliação de habilidades, estilo de comunicação | Permanente + atualização automática | Dinâmica |
4. Memória de Trabalho
A memória de trabalho armazena o contexto ativo da conversa atual em formato JSON com session_id, entidades, intenção e janela de contexto.
5. Memória de Longo Prazo
(1) Extração Automática de Memória
O Hermes extrai automaticamente informações importantes das conversas (projeto, stack tecnológica, etc.) e armazena na memória de longo prazo.
(2) Recuperação Semântica
Quando o usuário menciona algo relevante, o Hermes recupera automaticamente da memória de longo prazo usando busca semântica (não busca por palavras-chave).
(3) Comando /remember
/remember Preciso enviar um relatório semanal toda sexta
/remember list
/remember delete 3
/remember export > my_memories.json
6. Modelagem de Usuário Honcho
(1) O Que É Honcho?
Honcho é o motor de compreensão do usuário do Hermes — não apenas armazena preferências, mas modela padrões comportamentais.
(2) Dimensões do Perfil do Usuário
| Dimensão | Exemplo | Propósito |
|---|---|---|
| Habilidade técnica | ⭐⭐⭐⭐ (Avançado) | Ajustar profundidade da explicação |
| Estilo de comunicação | Conciso e direto | Adequar estilo de resposta |
| Preferência de código | Type-safety primeiro | Estilo de geração de código |
| Modo de aprendizado | Orientado à prática | Abordagem de ensino |
(3) Ver Seu Perfil
/honcho profile
# 🧑💻 User Profile
# Technical skill: ⭐⭐⭐⭐⭐ (Senior developer)
# Preferred languages: TypeScript > Python > Go
# Code style: Strict typing + functional
# Communication: Concise, no fluff
7. Comandos de Gerenciamento de Memória
| Comando | Função |
|---|---|
/remember <conteúdo> |
Salvar memória |
/remember list |
Listar todas as memórias |
/remember search <palavra-chave> |
Busca semântica de memórias |
/remember delete <id> |
Deletar memória |
/remember export |
Exportar memórias |
/honcho profile |
Ver perfil do usuário |
/honcho reset |
Resetar perfil do usuário |
❓ Perguntas Frequentes
P: Quanto espaço em disco a memória usa? R: ~1-2 KB por entrada (incluindo embedding), 1000 entradas ≈ 2 MB. Uso a longo prazo tipicamente fica abaixo de 50 MB.
P: Onde os dados de memória são armazenados? R: Padrão
~/.hermes/memory/. Configurável, suporta armazenamento criptografado.
P: Como limpar toda a memória? R:
/remember delete --allou delete o diretório~/.hermes/memory/. Exporte backup primeiro.
P: Honcho vaza privacidade? R: Dados do Honcho são totalmente locais, zero upload. Perfis de usuário são usados apenas para personalização, nunca enviados a terceiros.
📖 Resumo
- Três camadas: Memória de Trabalho (sessão) → Memória de Longo Prazo (entre sessões) → Modelo do Usuário (perfil profundo)
/rememberpara salvamentos manuais; o Agente extrai automaticamente informações importantes- Recuperação semântica, não busca por palavras-chave
- Honcho modela automaticamente o comportamento do usuário, continuamente atualizado
- Todos os dados armazenados localmente, zero vazamento de privacidade
📝 Exercícios
- Básico (⭐): Salve 5 preferências com
/remember, verifique a recuperação em uma nova conversa. - Intermediário (⭐⭐): Observe como o Honcho atualiza automaticamente seu perfil de usuário, documente 3 instâncias de atualização automática.
- Avançado (⭐⭐⭐): Projete um sistema de classificação de memória (por projeto/preferência/hábitos/normas de equipe), importe no Hermes e verifique a recuperação.