> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Memory

> Memory e personalização em ClickHouse Agents

[Recurso beta](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

é um armazenamento por usuário que o agente pode recuperar em várias conversas. Ele é composto por várias entradas, cada uma delas um par chave-valor — seu
formato de data preferido, o banco de dados que você costuma consultar, o quão concisas você quer as respostas. O agente traz essas informações para o contexto quando elas se aplicam.

## Como a Memory funciona

Um pequeno agente de Memory funciona junto com a conversa principal. Ele lê mensagens recentes, decide o que vale a pena lembrar e grava entradas em um armazenamento por usuário.
Na conversa seguinte, essas entradas ficam disponíveis como contexto que o agente principal pode consultar sem que você precise se repetir.

Na prática, isso se traduz em continuidade: diga uma vez a um agente que você prefere a saída SQL em letras minúsculas e que seu ano fiscal termina em março, e as conversas futuras se ajustarão a isso.

## Gerencie suas memórias

Abra o painel de Memory pelo ícone **Memories** (cérebro) na navegação à esquerda. O painel lista as memórias armazenadas, com controles para criar, editar, excluir e filtrar entradas.

![Painel Memories mostrando o ícone de cérebro destacado na navegação à esquerda, um campo de filtro, um botão Add, uma caixa de seleção Use memory, uma entrada de Memory com controles de edição e exclusão e um botão Admin Settings](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/memories.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=be40fec929722ddd7b6ea9f16d916d53)

O Memory é privado para cada usuário. Os agentes de outras pessoas nunca veem suas entradas, e os seus agentes nunca veem as delas.

### Criar uma Memory

Clique no botão **+** na parte superior do painel para abrir a caixa de diálogo **Criar Memory**. Insira uma **Chave** (apenas letras minúsculas e sublinhados) e um **Valor** e, em seguida, clique em **Criar**.

![Painel de Memory com o botão + de Criar Memory destacado](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/create.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=e269376c2af8fc0977bc3480b95d26c5)

### Filtrar Memories

Use o campo **Filtrar Memories** no topo do painel para localizar uma entrada pela chave.

![Painel de Memory com o campo Filtrar Memories destacado e 'demo' digitado](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/filter.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=645845ce90fb230bc74cb7bd549dbe91)

### Editar uma Memory

Clique no ícone de lápis em uma Memory para abrir a caixa de diálogo **Editar Memory**. Ajuste a Chave ou o Valor e clique em **Salvar**.

![Entrada de Memory com o ícone de lápis de Editar Memory destacado](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/edit.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=66cdf10cec6a546d064159f4c0856ce9)

### Excluir uma Memory

Clique no ícone de lixeira de uma Memory para removê-la.

![Entrada de Memory com o ícone de lixeira Excluir Memory destacado](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/delete.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=5b5119248aef464b26d0549cb68a8187)

## Ativar/desativar a Memory

Ative ou desative a Memory com a caixa de seleção **Use memory** na parte superior do painel de Memory. Desative-a para tópicos sensíveis que você não queira armazenar ou para conversas pontuais em que a personalização não seja útil.

Quando a Memory está desativada, o agente não lê nem grava nada no seu repositório de Memory.

![Painel de Memory com a caixa de seleção Use memory destacada na parte superior](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/toggle.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=9944cd3c5a5afe64aa936198bbb6d118)

## Boas práticas de Memory

Memory pode ajudar quando:

* Convenções recorrentes: formatos de data preferidos, definições de negócio, padrões de nomenclatura.
* Contexto do projeto: qual serviço ou banco de dados você costuma consultar, quais painéis são importantes para você.
* Estilo de comunicação: respostas mais sucintas ou mais detalhadas, com mais código ou mais texto corrido.

Memory não foi criado para ser usado como um banco de dados. Por exemplo, não é um lugar para despejar grandes volumes de material de referência.
Em vez disso, use uma [skill](https://clickhouse.com/docs/pt-BR/agents/builder/skills.md) ou incorpore esse material às instruções do agente.
Ele também não foi criado para recuperar informações de chats anteriores; o próprio histórico da conversa cumpre esse papel.
