> ## 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 and personalization in ClickHouse Agents

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

is a per-user store the agent can recall across conversations. It is composed of several entries, each one a key-value pair - your preferred
date format, the database you usually query, how terse you want responses. The agent pulls these into context when they apply.

## How memory works

A small memory agent runs alongside the main conversation. It reads recent messages, decides what's worth remembering, and writes entries to a per-user store.
On the next conversation, those entries are available as context the main agent can reference without you having to repeat yourself.

You see this as continuity: tell an agent once that you prefer SQL output in lowercase and that your fiscal year ends in March, and future conversations behave accordingly.

## Manage your memories

Open the memory panel from the **Memories** (brain) icon in the left navigation. The panel lists your stored memories with controls to create, edit, delete, and filter entries.

![Memories panel showing the brain icon highlighted in the left navigation, a filter input, an Add button, a Use memory checkbox, a memory entry with edit and delete controls, and an Admin Settings button](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/memories.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=be40fec929722ddd7b6ea9f16d916d53)

Memory is private to your user. Other people's agents never see your entries, and your agents never see theirs.

### Create a memory

Click the **+** button at the top of the panel to open the **Create Memory** dialog. Enter a **Key** (lowercase letters and underscores only) and a **Value**, then click **Create**.

![Memory panel with the Create Memory + button highlighted](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/create.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=e269376c2af8fc0977bc3480b95d26c5)

### Filter memories

Use the **Filter memories** input at the top of the panel to find an entry by key.

![Memory panel with the Filter memories input highlighted and 'demo' typed in](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/filter.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=645845ce90fb230bc74cb7bd549dbe91)

### Edit a memory

Click the pencil icon on a memory to open the **Edit Memory** dialog. Adjust the Key or Value and click **Save**.

![Memory entry with the Edit Memory pencil icon highlighted](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/edit.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=66cdf10cec6a546d064159f4c0856ce9)

### Delete a memory

Click the trash icon on a memory to remove it.

![Memory entry with the Delete Memory trash icon highlighted](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/delete.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=5b5119248aef464b26d0549cb68a8187)

## Toggle memory

Turn memory on or off with the **Use memory** checkbox at the top of the memory panel. Disable it for sensitive topics you don't want stored, or for one-off conversations where personalization isn't helpful.

When memory is off, the agent neither reads from nor writes to your memory store.

![Memory panel with the Use memory checkbox highlighted at the top](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/toggle.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=9944cd3c5a5afe64aa936198bbb6d118)

## Memory best practices

Memory can help when:

* Recurring conventions: preferred date formats, business definitions, naming patterns.
* Project context: which service or database you usually query, which dashboards you care about.
* Communication style: terse versus chatty, code-heavy versus prose-heavy responses.

Memory isn't intended to be used as a database. It's not a place to dump large reference material, for example.
You should rather use a [skill](https://clickhouse.com/docs/agents/builder/skills.md) or bake the material into the agent's instructions for that.
It's also not intended for retrieval over past chats; the conversation history itself plays that role.
