> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Memory

> Memory and personalization in ClickHouse Agents

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

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>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

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.

<h2 id="how-it-works">
  How memory works
</h2>

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.

<h2 id="manage-your-memories">
  Manage your memories
</h2>

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.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/memory/memories.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=8b1e28c7d2704cb790d081ac7dd77b42" alt="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" size="sm" width="714" height="862" data-path="images/cloud/agent-builder/memory/memories.png" />

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

<h3 id="create-memory">
  Create a memory
</h3>

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

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/memory/create.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=e7fd3e5e7465e954ca4d16d649b88d4a" alt="Memory panel with the Create Memory + button highlighted" size="sm" width="782" height="862" data-path="images/cloud/agent-builder/memory/create.png" />

<h3 id="filter-memories">
  Filter memories
</h3>

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

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/memory/filter.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=1682c73febbca4412f1245dced017957" alt="Memory panel with the Filter memories input highlighted and 'demo' typed in" size="sm" width="720" height="848" data-path="images/cloud/agent-builder/memory/filter.png" />

<h3 id="edit-memory">
  Edit a memory
</h3>

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

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/memory/edit.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=90be376a7566b7e5ac97e0919be418d5" alt="Memory entry with the Edit Memory pencil icon highlighted" size="sm" width="718" height="884" data-path="images/cloud/agent-builder/memory/edit.png" />

<h3 id="delete-memory">
  Delete a memory
</h3>

Click the trash icon on a memory to remove it.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/memory/delete.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=448abcbe1298ca5e11ab608fbea5add3" alt="Memory entry with the Delete Memory trash icon highlighted" size="sm" width="768" height="848" data-path="images/cloud/agent-builder/memory/delete.png" />

<h2 id="toggle-memory">
  Toggle memory
</h2>

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.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/memory/toggle.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=87303fde9fc7f62dd4b39e5eb5e8ffa8" alt="Memory panel with the Use memory checkbox highlighted at the top" size="sm" width="720" height="848" data-path="images/cloud/agent-builder/memory/toggle.png" />

<h2 id="memory-best-practices">
  Memory best practices
</h2>

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