Utilização do Banco de Memória AI
O banco de memória AI é a memória de longo prazo que o MBAgent guarda entre sessões. Permite ao AI "lembrar-se" das suas preferências, informações de conta e regras de negócio, evitando ter de as reexplicar em cada nova sessão.
NOTE
Descrição da captura de ecrã: Capturas de ecrã da UI de gestão do banco de memória AI (lista de entradas de memória, filtragem por categoria, botões de adicionar/editar/eliminar memória) serão progressivamente suplementadas na v1.x. Esta secção opera por passos em texto.
1. O Que É a Memória AI?
O MBAgent distingue dois tipos de "memória":
| Tipo | Âmbito | Finalidade |
|---|---|---|
| Memória ao nível da sessão | Apenas conversa atual | "Aquele número de há pouco" o AI lembra-se |
| Banco de memória AI local | Permanente entre sessões | As suas preferências, contas, regras de negócio |
TIP
Analogia: A memória ao nível da sessão é "a memória temporária deste chat"; o banco de memória AI local é "o seu perfil privado".
2. O Que Pode o Banco de Memória AI Armazenar?
Conteúdo adequado:
- ✅ As suas preferências ("O estilo de resposta deve ser formal, rigoroso, sem emojis")
- ✅ Info de conta ("O ID da minha conta Mbbrowser é 123456")
- ✅ Regras de negócio ("O ID do cliente é sempre uma string de 32 caracteres")
- ✅ Factos importantes ("A nossa empresa faz principalmente mercados europeus/americanos")
- ✅ Termos comuns ("GMV = Gross Merchandise Value")
Conteúdo inadequado:
- ❌ Info temporária ("As encomendas de hoje são 100")
- ❌ Credenciais sensíveis (palavra-passe / Token / API Key) → vão para o gestor de credenciais
- ❌ Documentos longos → vão para a base de conhecimento KMS
3. Onde Está Armazenado o Banco de Memória AI?
Os ficheiros do banco de memória são guardados no diretório de configuração do utilizador do MBAgent:
%LOCALAPPDATA%\mbagent\memory\
├── user.md ← Memória ao nível do utilizador (partilhada por todas as sessões)
├── project\
│ ├── my-project.md ← Memória ao nível do projeto (apenas visível para o projeto atual)
│ └── ...- Memória ao nível do utilizador: Todos os workspaces e todas as sessões partilham
- Memória ao nível do projeto: Apenas visível para sessões no workspace atual (diretório do projeto)
4. Adicionar Memória
Método 1: Dizer ao AI Diretamente na Conversa
A adição mais natural:
Utilizador: Lembre-se que a minha conta principal Mbbrowser é 123456789, principalmente mercado europeu/americano Amazon.
MBAgent: OK, adicionei ao seu banco de memória AI local.
O AI auto-julga o que vale a pena lembrar.
Método 2: Adicionar Manualmente na UI de Gestão do Banco de Memória
- Clique na entrada "Banco de Memória AI Local" na barra lateral esquerda
- Clique no botão "+"
- Escolha o tipo de memória (ao nível do utilizador / ao nível do projeto)
- Insira o título e conteúdo
- Clique em "Guardar"
Método 3: Usar Slash Command
Digite na caixa de entrada do chat:
/memory add A minha conta principal Mbbrowser é 123456789O AI categoriza automaticamente em categorias de memória adequadas.
Método 4: Destilar da Conversa
- Encontre um pedaço de informação útil no chat
- Clique com o botão direito → "Adicionar à Memória"
- Escolha o tipo de memória (ao nível do utilizador / ao nível do projeto)
- Guarde
5. Tipo de Memória e Categorias
O banco de memória AI suporta múltiplas categorias para fácil gestão:
| Tipo | Finalidade | Exemplo |
|---|---|---|
| Info de conta | Conta Mbbrowser, ID de API Key (não a Key real) | "Conta principal 123456" |
| Regras de negócio | Workflow, convenções de nomenclatura | "ID do cliente 32 caracteres" |
| Preferências | Estilo de escrita, formato de resposta | "Resposta formal e rigorosa" |
| Factos importantes | Contexto de negócio, info da empresa | "Negócio principal Amazon europeu/americano" |
| Termos comuns | Vocabulário profissional | "GMV = total de vendas" |
| Outro | Qualquer coisa não nas categorias acima | "Domínio do gateway API" |
6. Ver e Editar Memória
Ver Toda a Memória
- Clique na barra lateral esquerda "Banco de Memória AI Local"
- O navegador de memória aparece, exibindo todas as entradas de memória
- Filtre por categoria, ordene por tempo
Editar Memória
- Clique em qualquer entrada na lista de memória
- O painel de edição aparece à direita
- Modifique o título, conteúdo, categoria
- Clique em "Guardar"
Eliminar Memória
- Selecione a memória a eliminar
- Clique no botão "Eliminar"
- Confirme a eliminação (irrecuperável)
TIP
Limpeza periódica: Recomendado limpar o banco de memória mensalmente, removendo informação desatualizada ou errada.
7. Como É Que o AI Usa a Memória?
Recuperação Automática
No início de cada nova sessão, o MBAgent automaticamente recupera memórias relacionadas com a tarefa atual do banco de memória AI e inclui-as como parte do system prompt.
Por exemplo, pergunta "Como estão as encomendas da minha conta principal hoje?":
- O AI recupera automaticamente a memória "conta principal 123456"
- Chama automaticamente a API Mbbrowser para consultar as encomendas de hoje de 123456
- Não precisa de repetir "a minha conta principal é 123456"
Referência Ativa
O AI menciona explicitamente o que "lembra" nas respostas:
"Conforme as minhas preferências previamente registadas, vou responder em estilo formal rigoroso."
Destilação de Aprendizagem
Quando autoLearn está ativado, o MBAgent destila automaticamente "conversas significativas" em memória:
- Vá a "Definições → Preferências"
- Encontre a opção "autoLearn"
- Uma vez ativada, o MBAgent analisa cada conversa
- Adiciona automaticamente conteúdo "que vale a pena lembrar" ao banco de memória
self_learn(separado da sua memória ativa)
8. Melhores Práticas do Banco de Memória
Recomendações
✅ Construa algumas memórias chave na primeira vez que usar o MBAgent:
- O ID da sua conta principal Mbbrowser
- Âmbito do negócio principal
- Estilo de resposta preferido
✅ Se notar que o AI faz repetidamente a mesma pergunta, registe imediatamente:
- O AI pergunta repetidamente "Qual é o seu ID de cliente?" → registe-o
✅ Use diferentes âmbitos de memória para diferentes projetos:
- Memória do Projeto A apenas no diretório do Projeto A
- Memória ao nível do utilizador contém informação genérica
✅ As memórias devem ter estrutura:
- Títulos claros
- Conteúdo conciso
- Organize com listas markdown
Anti-padrões
❌ Não coloque credenciais sensíveis no banco de memória:
- Palavras-passe, Tokens, API Keys vão para o gestor de credenciais
- Os ficheiros do banco de memória são texto simples, não encriptados
❌ Não enfie documentos inteiros no banco de memória:
- Documentos e materiais de referência vão para a base de conhecimento KMS
- O banco de memória apenas contém "regras, preferências, factos chave"
❌ Não deixe o banco de memória expandir excessivamente:
- Muitas memórias diluem a atenção do AI
- Mantenha as entradas de memória < 50
9. Banco de Memória vs Outras Funcionalidades
| Funcionalidade | Finalidade | Tamanho |
|---|---|---|
| Banco de Memória AI | Preferências, regras, factos chave | Pequeno (nível KB) |
| Base de Conhecimento Local (KMS) | Documentos completos, materiais de referência | Grande (nível MB) |
| Sessão | Histórico completo de uma conversa | Médio (nível KB-MB) |
| RAG KB oficial Mbbrowser | Recuperação remota de negócio Mbbrowser | Remoto |
TIP
Qual escolher:
- Preferências simples → Banco de Memória AI
- Documentos completos → KMS
- Q&A único → Sessão
- Conhecimento de negócio Mbbrowser → Mbbrowser RAG
10. Resolução de Problemas do Banco de Memória
Q1: O AI parece não "lembrar" o que disse antes
Possíveis causas:
- Falha ao guardar no banco de memória
- Memória auto-ignorada (não relevante para a tarefa atual)
- Ficheiro do banco de memória corrompido
Resolução:
- Vá ao "Banco de Memória AI Local" para verificar se a memória existe
- Peça manualmente ao AI para lembrar de novo e confirme explicitamente
Q2: O AI usou a memória errada
Possíveis causas:
- Categoria de memória errada (ao nível do utilizador colocada ao nível do projeto)
- Conteúdo da memória desatualizado
Resolução:
- Edite essa memória
- Corrija ou elimine
Q3: Como fazer backup do banco de memória?
- Encontre o diretório do banco de memória
%LOCALAPPDATA%\mbagent\memory\ - Copie a pasta inteira para um local de backup
- Inverta a operação para restaurar
Q4: As memórias podem ser sincronizadas entre diferentes computadores?
✅ Sim, mas manual:
- Exporte memórias no computador A (pasta de backup)
- Importe no computador B (sobrescrever pasta)
- Reinicie o MBAgent
NOTE
O Mbbrowser ainda não fornece serviço de sincronização de memória na nuvem. Recomenda-se backup manual de memórias importantes.
Próximo: Integração Mbbrowser ControlV2 → Conectar o MBAgent com o Mbbrowser.