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

# Memory

> ClickHouse Agents の Memory とパーソナライズ

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>ベータ</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                ベータ機能です。 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        詳しくはこちら。
                    </a>
                </u>
            </span>
        </div>;
};

エージェントが会話をまたいで参照できる、ユーザーごとの保存領域です。複数のエントリで構成されており、それぞれが秘密鍵・バリューの組になっています。たとえば、希望する
日付フォーマット、普段クエリするデータベース、回答をどれくらい簡潔にしてほしいかといった情報です。エージェントは、必要に応じてこれらをコンテキストに取り込みます。

<div id="how-it-works">
  ## Memory の仕組み
</div>

小さな Memory エージェントが、メインの会話と並行して動作します。直近のメッセージを読み取り、何を記憶しておくべきかを判断し、ユーザーごとの保存領域にエントリを書き込みます。
次の会話では、それらのエントリを文脈として参照できるため、同じことを繰り返し伝える必要がありません。

その結果、会話に一貫性が生まれます。たとえば、SQL の出力は小文字がよいことや、会計年度が 3 月に終わることを一度エージェントに伝えておけば、その後の会話でもそれが反映されます。

<div id="manage-your-memories">
  ## Memory を管理する
</div>

左側のナビゲーションにある **Memories** (脳の) アイコンから Memory パネルを開きます。このパネルには保存されている Memory が一覧表示され、エントリの作成、編集、削除、絞り込みを行えます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/memories.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=e24e0bde7820f6de3632acee9cba07bc" alt="左側のナビゲーションで脳のアイコンが強調表示され、フィルター入力欄、Add ボタン、Use memory チェックボックス、編集および削除の操作が付いた Memory エントリ、Admin Settings ボタンが表示されている Memories パネル" size="sm" width="714" height="862" data-path="images/cloud/agent-builder/memory/memories.png" />

Memory はユーザーごとに非公開です。他のユーザーのエージェントがあなたのエントリを見ることはなく、あなたのエージェントがそのユーザーのエントリを見ることもありません。

<div id="create-memory">
  ### Memory を作成する
</div>

パネル上部の **+** ボタンをクリックして **Create Memory** ダイアログを開きます。**秘密鍵** (使用できるのは小文字とアンダースコアのみ) と **値** を入力し、**Create** をクリックします。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/create.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=975cf2cda04c354a799d9910dff3061f" alt="Create Memory の + ボタンが強調表示された Memory パネル" size="sm" width="782" height="862" data-path="images/cloud/agent-builder/memory/create.png" />

<div id="filter-memories">
  ### Memory を絞り込む
</div>

パネル上部の **Memory を絞り込む** 入力欄を使うと、キーでエントリを検索できます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/filter.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=f3c702a4e60ed546975a84049d3c886d" alt="「Memory を絞り込む」入力欄が強調表示され、「demo」と入力された Memory パネル" size="sm" width="720" height="848" data-path="images/cloud/agent-builder/memory/filter.png" />

<div id="edit-memory">
  ### Memory を編集する
</div>

Memory の鉛筆アイコンをクリックして、**Edit Memory**ダイアログを開きます。秘密鍵または値を変更し、**Save**をクリックします。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/edit.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=88a8cb385eb2f1591ad630cfe6312573" alt="Edit Memory の鉛筆アイコンが強調表示されたMemoryエントリ" size="sm" width="718" height="884" data-path="images/cloud/agent-builder/memory/edit.png" />

<div id="delete-memory">
  ### メモリを削除する
</div>

削除するには、メモリのごみ箱アイコンをクリックします。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/delete.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=c10e6627d1db318f88ac39985d1271ee" alt="削除用のごみ箱アイコンが強調表示された Memory エントリ" size="sm" width="768" height="848" data-path="images/cloud/agent-builder/memory/delete.png" />

<div id="toggle-memory">
  ## Memory の切り替え
</div>

Memory パネル上部にある **Use memory** チェックボックスで、Memory のオン/オフを切り替えます。保存したくない機密性の高いトピックや、パーソナライズが不要な単発の会話では、無効にしてください。

Memory がオフのとき、エージェントは Memory ストアの読み取りも書き込みも行いません。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/toggle.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=da7f9f89b461d3a7c08e128452582baa" alt="上部の Use memory チェックボックスが強調表示された Memory パネル" size="sm" width="720" height="848" data-path="images/cloud/agent-builder/memory/toggle.png" />

<div id="memory-best-practices">
  ## Memory のベストプラクティス
</div>

Memory が役立つのは、次のような場合です。

* 繰り返し使うルール: 好みの日付フォーマット、業務上の定義、命名パターン。
* プロジェクトのコンテキスト: 普段どのサービスやデータベースをクエリするか、どのダッシュボードを重視しているか。
* コミュニケーションスタイル: 簡潔な応答を好むか詳しい応答を好むか、コード中心か文章中心か。

Memory はデータベースとして使うことを意図したものではありません。たとえば、大量の参考資料を保存しておく場所ではありません。
そうした用途には、代わりに [スキル](/ja/products/cloud/features/ai-ml/agents/builder/skills) を使うか、その内容をエージェントの指示に組み込むべきです。
また、過去のチャットから情報を取り出すためのものでもありません。その役割は会話履歴自体が担います。
