> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/persistent-memory.md).

# 永続メモリ

Agent が対話から事実や好みを抽出して長期保存し、Agent の設定ページで各記憶の確認、削除、再有効化を行えます

永続記憶を使うと、Agent は対話中に覚えておくべき事実（連絡先の好みや以前に提供された情報など）を抽出して保存し、同じ連絡先との後の対話でそのまま活用できます。毎回聞き直す必要はありません。

これは「対話記憶設定」のベクトル記憶や対話横断検索とは異なります。後者の2つは回答時に過去のメッセージを**検索**しますが、永続記憶は対話を**個々の構造化された記憶に整理**して長期保存します。3つの違いは [Agent の記憶](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent.md#memory)をご覧ください。

## 有効化の方法 <a href="#enable" id="enable"></a>

永続記憶は**組織レベル**で制御されており、個々の Agent では有効化や無効化を行えません。有効化または無効化するには、組織の管理者または MaiAgent の担当窓口にお問い合わせください。

Agent の設定ページで現在の状態を確認できます。

1. 「<mark style="color:blue;">AI 機能</mark>」→「<mark style="color:blue;">AI アシスタント</mark>」を開き、確認したい Agent を選択します。
2. 左側のナビゲーションで「<mark style="color:blue;">管理と詳細設定</mark>」→「<mark style="color:blue;">詳細設定</mark>」をクリックします。
3. 「<mark style="color:blue;">永続記憶</mark>」セクションまでスクロールします。「<mark style="color:blue;">対話横断記憶</mark>」の横のラベルに、<mark style="color:blue;">有効</mark>または<mark style="color:blue;">無効</mark>と表示されます。

{% hint style="info" %}
組織で機能が有効になっており、Agent の作成が完了している場合（作成ダイアログ以外）にのみ、セクションの下に「<mark style="color:blue;">記憶一覧</mark>」が表示されます。
{% endhint %}

## メンバー個人記憶のスイッチ <a href="#member-memory-switches" id="member-memory-switches"></a>

「<mark style="color:blue;">永続記憶</mark>」セクションには、Agent レベルのスイッチがさらに2つあります。この Agent と、組織メンバーの [AI メモリ](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/ai-memory.md)（メンバーの個人記憶）がどのように連携するかを決めるものです。2つのスイッチは互いに独立しており、この Agent の編集権限を持つユーザーが調整できます。組織で対話横断記憶が有効になっていない場合は、グレーアウトされて切り替えられません。

| スイッチ                                           | オンの場合                                                 | オフの場合                                                 |
| ---------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------- |
| <mark style="color:blue;">メンバー個人記憶に書き込む</mark> | メンバーがこの Agent に話した自分自身に関する内容が、そのメンバーの個人 AI メモリに保存されます | メンバーがこの Agent に話した内容は個人 AI メモリに保存されません                |
| <mark style="color:blue;">メンバー個人記憶を参照する</mark> | この Agent がメンバーに回答するとき、そのメンバーの個人 AI メモリを参照します          | この Agent がメンバーに回答するとき、個人 AI メモリを参照せず、顧客への回答と同じ動作になります |

MaiGPT では2つのスイッチがどちらも初期状態でオンです。その他の Agent は初期状態でオフで、必要に応じて管理者がオンにします。

たとえば、カスタマーサービス担当マネージャーが管理画面でカスタマーサービス Agent を使って顧客役を演じ、回答をテストするときに、「高血圧なのですが、この健康食品は食べても大丈夫ですか？」と入力したとします。この Agent で「<mark style="color:blue;">メンバー個人記憶に書き込む</mark>」がオンになっていると、この顧客の状況がマネージャー本人の記憶として保存されます。その後、マネージャーが「<mark style="color:blue;">メンバー個人記憶を参照する</mark>」がオンの Agent（MaiGPT など）を使うと、この記憶も参照されます。メンバーがカスタマーサービスの回答テストや他の人の代理入力に使う Agent では、「<mark style="color:blue;">メンバー個人記憶に書き込む</mark>」をオフのままにしてください。

## 記憶一覧 <a href="#memory-list" id="memory-list"></a>

「<mark style="color:blue;">記憶一覧</mark>」には、この Agent が現在保存しているすべての記憶が表示されます。タイトル横の数字は総件数です。右側の「<mark style="color:blue;">更新</mark>」をクリックすると再読み込みできます。各記憶には次の項目が含まれます。

| 項目          | 説明                                                                                                                                                                                                             |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Topic**   | 記憶のトピック識別子です。分類や照合に使用します                                                                                                                                                                                       |
| **Summary** | 記憶を一文でまとめた要約です。Agent は回答時に主にこの内容を参照します                                                                                                                                                                         |
| **Details** | 補足情報を項目ごとに表示します。詳細がない場合は「—」と表示されます                                                                                                                                                                             |
| 範囲ラベル       | 記憶が適用される範囲です。<mark style="color:blue;">組織</mark>、<mark style="color:blue;">メンバー</mark>、<mark style="color:blue;">アシスタント</mark>、<mark style="color:blue;">連絡先</mark>、<mark style="color:blue;">対話</mark>のいずれかです |
| 種類ラベル       | 記憶の性質です。<mark style="color:blue;">事実</mark>、<mark style="color:blue;">好み</mark>、<mark style="color:blue;">要約</mark>、<mark style="color:blue;">指示</mark>、<mark style="color:blue;">プロフィール</mark>のいずれかです         |
| 日付          | 記憶が作成された日付です                                                                                                                                                                                                   |

一覧が空の場合は「まだ記憶は記録されていません」と表示されます。Agent が対話から事実を抽出すると、ここに記憶が表示されます。

### 記憶の削除 <a href="#delete-memory" id="delete-memory"></a>

各記憶の右側に「<mark style="color:blue;">削除</mark>」があります。確認すると完全に削除され、Agent は以降の対話でその記憶を参照しなくなります。情報が誤って抽出された場合や、連絡先から特定の情報を忘れるよう求められた場合に使用します。

### 期限切れの記憶 <a href="#expired-memories" id="expired-memories"></a>

記憶は有効期限を過ぎてもすぐには消えず、一覧の下にある「<mark style="color:blue;">期限切れの記憶</mark>」の折りたたみセクションに移動します（括弧内は件数です）。破線の枠とグレーの表示になり、Agent はこれらの記憶を参照しません。セクションを展開すると、各記憶に2つの操作が表示されます。

* **再有効化**（↶ アイコン）：「この記憶を再有効化してもよろしいですか？」を確認すると、記憶が有効な状態に戻り、Agent が再び参照します。
* **削除**：完全に削除します。

{% hint style="warning" %}
記憶の内容は、連絡先が対話中に提供した情報に基づきます。組織のデータ利用とプライバシーに関する規則に従って管理してください。連絡先から個人データの削除を求められた場合は、関連する記憶も削除してください。
{% endhint %}

## API による管理 <a href="#api" id="api"></a>

独自のシステムで記憶の読み取りや管理を行うには、技術者向けマニュアルの [Member Memory API](https://docs.maiagent.ai/tech/api-integration/member-memory-api) を使用できます。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/persistent-memory.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
