> ## 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

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Funcionalidade Beta. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        Saiba mais.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

é 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.

<div id="how-it-works">
  ## Como a Memory funciona
</div>

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.

<div id="manage-your-memories">
  ## Gerencie suas memórias
</div>

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.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/memory/memories.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=65e0c16e932ff787809bca51bf4f8367" alt="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" size="sm" width="714" height="862" data-path="images/cloud/agent-builder/memory/memories.webp" />

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

<div id="create-memory">
  ### Criar uma Memory
</div>

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**.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/memory/create.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=3aeed16520a3311c7be88ad6327130b1" alt="Painel de Memory com o botão + de Criar Memory destacado" size="sm" width="782" height="862" data-path="images/cloud/agent-builder/memory/create.webp" />

<div id="filter-memories">
  ### Filtrar Memories
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/memory/filter.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=432a042d13d33b2370aed79df89bf839" alt="Painel de Memory com o campo Filtrar Memories destacado e 'demo' digitado" size="sm" width="720" height="848" data-path="images/cloud/agent-builder/memory/filter.webp" />

<div id="edit-memory">
  ### Editar uma Memory
</div>

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**.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/memory/edit.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=b01a63cc2aa21f056c0dfb174fe784e4" alt="Entrada de Memory com o ícone de lápis de Editar Memory destacado" size="sm" width="718" height="884" data-path="images/cloud/agent-builder/memory/edit.webp" />

<div id="delete-memory">
  ### Excluir uma Memory
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/memory/delete.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=320a9d3386661a18f99dc0fb50de3b23" alt="Entrada de Memory com o ícone de lixeira Excluir Memory destacado" size="sm" width="768" height="848" data-path="images/cloud/agent-builder/memory/delete.webp" />

<div id="toggle-memory">
  ## Ativar/desativar a Memory
</div>

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.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/memory/toggle.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=02be0a71c5794ff5172091ddb2efa5ec" alt="Painel de Memory com a caixa de seleção Use memory destacada na parte superior" size="sm" width="720" height="848" data-path="images/cloud/agent-builder/memory/toggle.webp" />

<div id="memory-best-practices">
  ## Boas práticas de Memory
</div>

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](/docs/pt-BR/products/cloud/features/ai-ml/agents/builder/skills) 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.
