---
title: Memória
description: Salve fatos estáveis e preferências que o Runner pode levar para trabalhos futuros.
---

Memória é para fatos concisos que o Runner deve reter, como uma preferência de escrita, uma regra de negócio corrigida ou uma decisão aprovada. Reduz explicações repetidas em tarefas.

## O que este guia cobre

Você poderá adicionar, encontrar, editar e excluir com segurança uma memória.

## Disponibilidade e pré-requisitos

- Você precisa de um projeto de loja.
- A aba **Memória** aparece apenas quando a Memória unificada está ativada para sua conta.
- Memória é separada do gate do plano Habilidades.
- Nunca salve senhas, chaves de API, detalhes de pagamento, credenciais privadas ou outros segredos em Memória.

## Caminho de entrada

Abra **Central de Controle → Agent → Memória**.

![Estado vazio da Memória do Agente](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgaHzZwHROeSy3rMW1RfUiItV0w2TbDmjnBYEJ)

## Controles de memória

| Entrada ou botão | Por que é útil | O que acontece depois |
| --- | --- | --- |
| **Adicionar uma memória** | Salve um novo fato para o Runner. | O diálogo **Nova memória** abre. |
| **Conteúdo** | Declare o fato que o Runner deve reter. | Este texto se torna a memória visível. |
| **Escopo** | Escolha onde o fato deve se aplicar. | Selecione **Esta loja**, **Pessoal** ou **Organização**. |
| **Tipo** | Explique que tipo de fato é. | Selecione Preferência, Correção, Convenção, Conhecimento ou Decisão. |
| **Tags** | Facilite encontrar e agrupar a memória. | Digite uma ou mais tags separadas por vírgula. Pelo menos uma tag é obrigatória para salvar. |
| **Importância** | Diga ao Runner com que força considerar o fato. | Selecione Baixa, Média ou Alta. |
| **Adicionar memória** | Salve uma nova memória válida. | O diálogo fecha após o sucesso e a memória aparece em seu grupo de escopo. |
| Ícone de edição | Corrija ou refine uma memória. | **Editar memória** abre com os valores atuais. |
| **Salvar** | Aplique uma edição. | A linha se atualiza após o sucesso da atualização. |
| Ícone de exclusão ou **Excluir** | Remova uma memória. | O Runner abre um diálogo de confirmação destrutiva. |

## Adicionar uma memória

1. Abra **Agent → Memória**.
2. Selecione **Adicionar uma memória**.
3. Escreva um fato claro em **Conteúdo**.
4. Escolha o **Escopo** mais restrito correto.
5. Escolha o **Tipo** mais próximo.
6. Adicione **Tags** úteis separadas por vírgula.
7. Defina **Importância**. Use Alta com moderação para fatos que o Runner deve priorizar quando as informações competem.
8. Selecione **Adicionar memória**.
9. Confirme que a nova linha aparece sob o escopo pretendido.

## Editar ou excluir uma memória

1. Encontre a memória navegando por seu grupo de escopo ou usando a busca.
2. Selecione o ícone de edição, atualize os campos e selecione **Salvar**.
3. Para removê-la, selecione o ícone de exclusão ou **Excluir** dentro do diálogo de edição.
4. Revise **Excluir memória** e selecione **Excluir** para confirmar.

Excluir uma memória não pode ser desfeito a partir deste diálogo. Cancelar fecha a confirmação sem removê-la.

## Estados e limites

- Uma nova conta pode mostrar **Nenhuma memória ainda** com uma ação **Adicionar uma memória**.
- Uma busca sem correspondência diz quantas memórias estão ocultas e oferece **Limpar busca**.
- Conteúdo e pelo menos uma tag são obrigatórios antes que o botão salvar fique disponível.
- As memórias são agrupadas por escopo e mostram seu tipo, escopo, contagem de uso e tempo de uso recente.
- Memória disponibiliza um fato para o Runner; não é uma garantia de que o fato substituirá todas as instruções ou limites de segurança.

## Solução de problemas

- Se a aba **Memória** estiver ausente, use a navegação visível em vez de um link direto antigo. O recurso não está ativado para a conta atual.
- Se **Adicionar memória** estiver desativado, adicione Conteúdo e pelo menos uma tag separada por vírgula.
- Se a lista parecer vazia após a busca, selecione **Limpar busca**.
- Se uma edição falhar, a memória anterior permanece. Corrija o problema exibido e tente novamente.
- Se uma memória está sendo aplicada muito amplamente, edite-a e escolha um escopo mais restrito.

## Guias relacionados

- [Tipos e escopos de memória](./memory-types-and-scopes)
- [Visão geral de Personalização do Agent](./)
- [Use a paleta de comandos do Agent](./command-palette)
- [Segurança de chave de API](../account-and-settings/api-keys)