Memória de agentes
Ligue a memória de um agente, escreva a instrução de memória e veja como ele guarda, consulta e esquece notas pelas ferramentas MCP e pela CLI.
A memória é um caderno privado de cada agente. Durante uma execução, o agente guarda o que aprendeu, como uma preferência da equipe, um atalho do repositório ou uma decisão que não deve ser rediscutida, e consulta essas notas nas execuções seguintes.
Ela é diferente de duas coisas parecidas:
| Quem lê | Quem escreve | Chega ao agente | |
|---|---|---|---|
| Instruções do agente | O próprio agente | Quem edita o agente | Sempre, no início de cada execução |
| Memória | Só o próprio agente | Só o próprio agente | Quando ele consulta, durante a execução |
| Base de conhecimento | Todo o workspace, pessoas e agentes | Pessoas e agentes | Quando ele consulta, durante a execução |
O conteúdo das memórias não é colocado no prompt. O agente decide quando listar, buscar e ler as próprias notas.
Quando a memória funciona
A memória de um agente só funciona com três chaves ligadas ao mesmo tempo:
- Plataforma. A administração da plataforma liga o recurso Memória de agentes para o workspace. Vem desligado por padrão.
- Espaço de trabalho. Em Configurações › Memória, proprietários e administradores do workspace ligam ou desligam Memória do espaço de trabalho, que vale para todos os agentes. Fica ligada por padrão quando a plataforma liga o recurso.
- Agente. Na página do agente, em Capacidades › Memória, o interruptor Memória do agente. Vem desligado em cada agente.
Nota
Desligar qualquer uma das chaves não apaga nada. As memórias e a instrução ficam guardadas e voltam a valer quando as três estiverem ligadas de novo. A mudança vale a partir da próxima chamada do agente.
Se a plataforma não ligou o recurso, a aba Memória do agente mostra Memória indisponível. Se foi o workspace que desligou, mostra Memória desligada no espaço de trabalho.
Ligar a memória de um agente
Abra a aba Memória
Em Agentes, abra o agente e vá a Capacidades › Memória. A aba aparece para todos que têm acesso ao agente, mas só quem pode editá-lo muda as configurações.
Ligue o interruptor
Ative Memória do agente. A mudança é salva na hora; se falhar, o interruptor volta ao valor anterior e um aviso aparece.
Escreva a instrução de memória
Em Instrução de memória, diga ao agente o que guardar, quando consultar e quando esquecer. Por exemplo:
Guarde decisões técnicas e preferências da equipe que valem para tarefas futuras.
Antes de começar uma tarefa, busque nas suas memórias pelo nome do repositório.
Esqueça uma memória quando ela deixar de ser verdade.Use Salvar. A instrução é anexada às instruções do agente no início de cada execução e aceita até 32 KB.
Como o agente usa a memória
Quando a memória está ativa, o daemon entrega ao agente um servidor MCP local, jiraya-memory, com cinco ferramentas:
| Ferramenta | O que faz |
|---|---|
memory_list | Lista as memórias do agente, da mais recente para a mais antiga. |
memory_search | Busca um trecho na chave ou no conteúdo, sem diferenciar maiúsculas. |
memory_read | Lê uma memória pela chave. |
memory_write | Cria uma memória ou substitui o conteúdo de uma chave existente. |
memory_forget | Apaga uma memória pela chave. |
Com a memória desligada, o servidor não é iniciado e as ferramentas não aparecem para o agente.
Para ferramentas de IA que não usam MCP, as mesmas operações existem na CLI, com jiraya memory:
jiraya memory set repo/convencao-de-commits --content "Commits em português, no formato tipo(escopo): descrição."jiraya memory search commits| Comando | O que faz |
|---|---|
jiraya memory list | Lista as memórias. Pagina com --limit (até 200), --cursor e --all. |
jiraya memory search <texto> | Busca na chave e no conteúdo. |
jiraya memory get <chave> | Mostra uma memória. |
jiraya memory set <chave> | Cria ou substitui uma memória, com --content, --content-file ou --content-stdin. |
jiraya memory forget <chave> | Apaga uma memória. |
Todos aceitam --output json. A referência completa está em jiraya memory.
Atenção
jiraya memory só funciona dentro de uma execução. O agente é identificado pelo token temporário da execução, então não existe opção para ler ou escrever a memória de outro agente. Fora de uma execução, ou com a memória desligada, o comando termina com erro de permissão.
Chaves e limites
Cada memória é endereçada por uma chave:
- começa com letra minúscula ou número;
- usa só letras minúsculas, números,
.,_,/e-; - tem até 120 caracteres.
Use / para agrupar, como repo/testes ou preferencias/revisao.
O conteúdo não pode ser vazio. Dois limites valem por workspace e aparecem em Configurações › Memória:
| Limite | Padrão e máximo | Ao passar do limite |
|---|---|---|
| Memórias por agente | 500 | Criar uma chave nova é recusado. Substituir uma chave existente continua funcionando. |
| Caracteres por memória | 16.000 | A gravação é recusada. |
Proprietários e administradores do workspace ajustam esses limites entre 1 e o máximo; os demais membros só os veem. Reduzir um limite não apaga memórias: vale para as próximas gravações, e um agente acima do novo teto só cria memórias novas depois de apagar algumas.
Segredos não ficam na memória
Antes de salvar, o Jiraya mascara no conteúdo os formatos conhecidos de credencial, como chaves de API e chaves privadas, e os valores dos segredos do workspace. O agente pode pedir para guardar um token por engano, mas o valor não chega ao banco.
Ver o que o agente guardou
A lista Memórias, na aba Memória do agente, mostra a chave, o conteúdo e quando cada memória foi atualizada. Use Carregar mais para ver as próximas.
A lista é somente leitura: nenhuma pessoa cria, edita ou apaga memórias pela interface. Para corrigir uma memória, peça ao agente numa tarefa ou ajuste a Instrução de memória para que ele esqueça o que estiver desatualizado.
Com a memória do agente desligada, a lista continua visível, com o aviso A memória está desligada. O agente ignora estas memórias.
Atualizado em