Memória

Memória é o que o agente guarda de uma conversa para a outra: a preferência de um cliente, um dado já informado, o conhecimento acumulado ao longo do tempo. Sem memória, cada conversa começa do zero.

Onde a memória é criada

Você pode criar memórias em três níveis, e o agente enxerga todas as que alcançam o nível dele:

Nível	Onde	Quem enxerga
Pasta	Pasta de soluções → aba Memória	Todas as soluções e agentes da pasta
Solução	Configurações → Memória	Todos os agentes daquela solução
Agente	Editor do agente → aba Memória	Apenas aquele agente

A herança flui de cima para baixo: uma memória criada na pasta aparece nas soluções dela marcada como Herdada. É assim que várias soluções compartilham o mesmo conhecimento sem duplicá-lo.

Os dois tipos

Ao clicar em + Nova memória, o primeiro passo é escolher o tipo.

Tipo	O que armazena	Use quando
Memória estruturada (chave/valor)	Dados organizados em campos definidos	Nome do cliente, preferências, flags, dados de cadastro
Memória inteligente (Semântica)	Textos e documentos, com busca por conteúdo	Anotações livres, histórico de casos, conhecimento acumulado

Na dúvida, comece pela estruturada: ela é previsível e fácil de auditar. A semântica brilha quando o conteúdo é texto corrido e você não sabe de antemão que campos existirão.

Os campos

Campo	O que faz
Nome	Como a memória é identificada
Alcance	Compartilhado, Individual ou Por conversa — veja abaixo
Descrição	Explica ao agente o que guardar aqui. É o campo que mais afeta a qualidade
Permissão padrão	Nenhuma, Somente leitura, Somente escrita ou Leitura e escrita
Injetar cabeçalho no prompt	Insere o cabeçalho da memória no contexto do agente
Injetar campos no prompt	Insere os valores já guardados no contexto
Permitir campos dinâmicos	Deixa o agente criar campos que você não previu
Propagar para todos os agentes automaticamente	Vincula a memória a todos os agentes sem precisar fazer um a um
Ativa	Desmarque para desativar sem excluir

Alcance

Alcance	Visibilidade
Compartilhado	Informação comum a todos os usuários, acessível a todos os agentes da solução
Individual	Separada por pessoa: cada usuário tem a sua
Por conversa	Vale apenas dentro daquela conversa

Escolha Individual para dados pessoais — preferências, endereço, histórico de compras. Use Compartilhado para conhecimento do negócio, não de pessoas.

Alcance e dados pessoais

Memória Compartilhada fica visível para qualquer pessoa que use a solução. Nunca guarde ali dados pessoais de clientes.

Permissão

A Permissão padrão define o que o agente pode fazer com a memória. Somente leitura é a escolha segura quando o conteúdo é curado por você e o agente só precisa consultar. Leitura e escrita deixa o agente aprender sozinho — e exige uma descrição bem escrita, ou ele guarda o que não deveria.

Vincular ao agente

Se você não marcou Propagar para todos os agentes automaticamente, abra o editor do agente, vá até a aba Memória e vincule a memória desejada.

A aba mostra a origem de cada memória — Herdada quando vem da pasta ou da solução — além do tipo, do alcance e se está ativa.

Quando o agente parece ter esquecido

Sintoma	Causa provável
O agente não lembra nada	A memória não está vinculada ao agente, ou está inativa
Lembra, mas não grava	Permissão em Somente leitura
Guarda a informação errada	Descrição vaga; diga explicitamente o que deve ser guardado
Um cliente vê o dado de outro	Alcance Compartilhado onde deveria ser Individual