> 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/work/maigpt/ai-memory.md).

# AI メモリ

Agent が会話から学んだ好みや事実を確認・管理します

AI メモリページでは、アカウントに現在保存されている好みや事実を確認・管理できます。自分のメモリの追加、編集、削除、再有効化を行えます。

{% hint style="info" %}
クラウド版では AI メモリがデフォルトで有効になっており、追加の申請は不要です。オンプレミス版で利用できるかどうかは組織の設定によって異なります。このページで自分の AI メモリをいつでもオフにできます。詳しくは [AI メモリのオン・オフ](#toggle-memory)をご覧ください。
{% endhint %}

## 利用する場面 <a href="#use-case" id="use-case"></a>

例えば、プロジェクトマネージャーがアカウントに保存されているコミュニケーションの好みを整理したい場合、<mark style="color:blue;">AI メモリ</mark>で既存の内容を確認し、「日本語で回答する」という好みを手動で追加できます。必要に応じて、いつでも編集や削除ができます。

## メモリ一覧を開く <a href="#open-memory-list" id="open-memory-list"></a>

右上のアカウントメニューをクリックし、<mark style="color:blue;">アカウント</mark>を選択します。プロフィールページの組織セクションで <mark style="color:blue;">AI メモリ</mark>をクリックします。ページに自分のメモリが一覧表示されます。まだデータがない場合は「メモリはまだありません」と表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-abad881f3ab1ac20097bc14dacc629a5ff640bf4%2Fai-memory-list.png?alt=media" alt="AI メモリページの空の状態。右上の追加ボタンをクリックできます"><figcaption><p>AI メモリ一覧の空の状態</p></figcaption></figure>

## AI メモリのオン・オフ <a href="#toggle-memory" id="toggle-memory"></a>

<mark style="color:blue;">AI メモリ</mark>ページの最上部には <mark style="color:blue;">アシスタントに自分を覚えてもらう</mark>スイッチがあり、デフォルトでオンになっています。Agent に自分を覚えてもらうかどうかを、必要に応じて選択できます。このスイッチは、現在の組織における自分のメモリにのみ影響します。同じ組織のほかのメンバーや、ほかの組織での自分の設定には影響しません。

{% stepper %}
{% step %}
右上のアカウントメニューをクリックし、<mark style="color:blue;">アカウント</mark>を選択します。プロフィールページで <mark style="color:blue;">AI メモリ</mark>をクリックします。
{% endstep %}

{% step %}
ページ最上部の <mark style="color:blue;">アシスタントに自分を覚えてもらう</mark>スイッチを切り替えます。切り替えに成功すると、「AI メモリを有効にしました」または「AI メモリを無効にしました」と表示されます。
{% endstep %}
{% endstepper %}

オフにすると、次のようになります。

* Agent は会話から新しい内容を記憶せず、「これを覚えて」という機能も利用できなくなります。
* Agent は会話中に保存済みのメモリを参照しません。
* 一覧の上部に「AI メモリは無効です。アシスタントは現在、メモリの読み取りや追加を行いません」と表示されます。

{% hint style="info" %}
スイッチをオフにしてもメモリは削除されません。保存済みのメモリは保持され、このページで確認、編集、削除、手動追加を引き続き行えます。再度オンにすると、Agent がこれらのメモリを再び使用します。オフの間の会話は、再度オンにした後も遡って記憶されません。
{% endhint %}

{% hint style="warning" %}
スイッチがオフで操作できず、「組織で AI メモリが有効になっていません」と表示される場合は、組織でこの機能が有効になっていません。この場合、Agent はどのメンバーについても記憶しません。不明点がある場合は、組織の管理者または MaiAgent サポートにお問い合わせください。
{% endhint %}

## メモリを手動で追加する <a href="#add-memory" id="add-memory"></a>

{% stepper %}
{% step %} <mark style="color:blue;">AI メモリ</mark>ページで、右上の <mark style="color:blue;">追加</mark>をクリックします。
{% endstep %}

{% step %}
種類を選択し、トピック、要約、詳細を入力します。トピックには `communication_style` など、英語の `snake_case` を使用します。詳細は1行に1項目ずつ入力できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-89edbfeec742e3fab67138f346e8bb7c09d254dd%2Fai-memory-add.png?alt=media" alt="AI メモリ追加フォーム。種類、トピック、要約、詳細の入力欄があります"><figcaption><p>メモリを手動で追加する際の入力項目</p></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">保存</mark>をクリックします。新しいメモリが一覧に表示されます。
{% endstep %}
{% endstepper %}

## 会話中に Agent に記憶を依頼する <a href="#save-in-chat" id="save-in-chat"></a>

<mark style="color:blue;">AI メモリ</mark>ページで手動追加するほか、会話中に Agent に「……を覚えてください」と直接伝えることもできます。Agent は内容を1件のメモリに整理してメモリ一覧に保存し、その後の会話で参照できるようにします。

Agent は、役職、希望する回答言語、よく使うスキルなど、長期的に役立つと判断した事実を会話中に自ら記録することもあります。

### 利用条件 <a href="#save-in-chat-requirements" id="save-in-chat-requirements"></a>

次の条件をすべて満たす場合にのみ、Agent は会話中にメモリを書き込めます。

* 組織で AI メモリが有効になっています。
* 自分の <mark style="color:blue;">アシスタントに自分を覚えてもらう</mark>スイッチがオンになっています（デフォルトでオンです）。
* Agent の設定で <mark style="color:blue;">ベクトルメモリ</mark>が有効になっています。
* 会話相手が、その Agent が所属する組織のメンバーです。匿名訪問者との会話はメモリに書き込まれません。

Agent マーケットプレイスの Agent を使用する場合も同じ条件が適用されます。その Agent が所属する組織のメンバーであれば、Agent は自分の AI メモリを利用できます。

{% hint style="warning" %}
Agent は、クレジットカード番号、個人識別番号、パスポート番号、銀行口座番号、携帯電話番号、Email、パスワード、API キーなどの機微な個人情報を保存しません。このような情報を含む内容はメモリに保存されず、Agent が保存できないことを伝えます。
{% endhint %}

### 利用例 <a href="#save-in-chat-scenario" id="save-in-chat-scenario"></a>

例えば、マーケティング担当者が MaiGPT で新製品のプレゼンテーションを準備しており、今後の会話で毎回製品のコードネームを説明する手間を省きたいとします。会話中に「覚えてください。デモ製品のコードネームは Aurora です。今後、製品紹介を書くときはこのコードネームを使ってください」と入力します。Agent は <mark style="color:blue;">Save Memory</mark>を実行し、記憶したことを返信します。<mark style="color:blue;">AI メモリ</mark>ページには、このメモリが <mark style="color:blue;">ユーザーの依頼</mark>と表示されます。その後、新しい会話で Agent に製品紹介の作成を依頼すると、Aurora というコードネームが使われます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-a97fd05d5498ebff8adf57d180d7d53c0e8603dd%2Fmaigpt-memory-save-in-chat.png?alt=media" alt="MaiGPT の会話でユーザーがデモ製品のコードネーム Aurora の記憶を依頼し、ステップ欄に Save Memory の使用が表示され、Agent が記憶したと返信しています"><figcaption><p>会話中に Agent に記憶を依頼すると、ステップ欄に Save Memory の使用が表示されます</p></figcaption></figure>

{% hint style="info" %}
Agent が書き込むメモリが既存のメモリと同じトピックの場合は、重複して追加せず、そのメモリを更新します。
{% endhint %}

## メモリのソースタグ <a href="#source-tags" id="source-tags"></a>

メモリ一覧の各メモリにはソースが表示されます。Agent が会話中に書き込んだメモリには、次のいずれかのタグが表示されます。

| タグ                                                 | 意味                             |
| -------------------------------------------------- | ------------------------------ |
| <mark style="color:blue;">ユーザーの依頼</mark>（緑色）       | 会話中に Agent に記憶するよう明示的に依頼した内容です |
| <mark style="color:blue;">アシスタントが自発的に記録</mark>（紫色） | Agent が会話中に自ら判断して保存した内容です      |

このページで自分が追加した <mark style="color:blue;">手動追加</mark>や、システムが会話内容から自動で整理した <mark style="color:blue;">AI 抽出</mark>など、ほかのソースタグが表示されることもあります。残したくないメモリがある場合は、以下の説明に従って編集または削除してください。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-1d67cfaf5ece4c4e3090598fce4d82f9d1d12ba6%2Fmaigpt-memory-source-tags.png?alt=media" alt="AI メモリ一覧の2件のメモリ。一方は事実と AI 抽出、もう一方はトピックが demo_product_code で、指示とユーザーの依頼が表示されています"><figcaption><p>メモリ一覧のソースタグ：AI 抽出とユーザーの依頼</p></figcaption></figure>

## 既存のメモリを管理する <a href="#manage" id="manage"></a>

メモリ一覧では、次の操作ができます。

* トピック、要約、詳細を編集します。
* 正確でなくなったメモリや、AI に使わせたくないメモリを削除します。削除後は復元できません。
* 「期限切れのメモリ」セクションで、期限切れの項目を再度有効にします。
* 更新ボタンをクリックし、一覧を最新の状態にします。

{% hint style="warning" %}
メモリは、その後の会話の回答に影響する場合があります。内容が古い、不正確、長期保存に適さない場合は、速やかに修正または削除してください。
{% endhint %}

## 使用量と料金 <a href="#usage-and-billing" id="usage-and-billing"></a>

AI メモリは、次の2つの用途で組織の Credits を使用します。

| 使用内容      | 料金の計算方法                                                                                                                                                                                                                                                          | 消費履歴での表示                                                                                                                                               |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| メモリの整理    | AI メモリが会話からメモリを整理・保存する際は、プラットフォームのシステムモデルが処理し、そのモデルの料金に従って Credits が差し引かれます。整理処理ごとに1件の履歴が記録されます。料金は記憶対象のメンバーに帰属します。メンバーのクォータや[ロールのクォータ](/maiagent-user-guide/ja/others/credits/member-credit-quota.md#role-quota)が設定されている場合は、そのメンバーの個人クォータと所属ロールのクォータからも差し引かれます。 | サービスカテゴリは <mark style="color:blue;">AI メモリ</mark>で、明細には <mark style="color:blue;">AI メモリ（入力）</mark>、<mark style="color:blue;">AI メモリ（出力）</mark>と表示されます |
| 回答時のメモリ参照 | Agent が回答時に取り込むメモリは、その返信の入力使用量に含まれ、Agent が使用するモデルに従って課金されます。                                                                                                                                                                                                     | その返信の入力行の横に「この入力には AI メモリ約 N tokens が含まれており、入力使用量に計上済みです」と表示されます                                                                                       |

次の場合はメモリを整理せず、AI メモリの消費も発生しません。

* <mark style="color:blue;">アシスタントに自分を覚えてもらう</mark>をオフにしている場合、組織で AI メモリが有効になっていない場合、匿名訪問者との会話の場合、または Agent の <mark style="color:blue;">ベクトルメモリ</mark>が有効になっていない場合です。
* メッセージに機微な個人情報が含まれている場合です。このようなメッセージは整理処理に送信されません。
* 組織の Credits が不足している場合、または記憶対象メンバーの個人クォータや所属ロールの[ロールのクォータ](/maiagent-user-guide/ja/others/credits/member-credit-quota.md#role-quota)を使い切っている場合です。
* 整理処理が失敗した場合です。

整理処理に成功しても、記憶すべき内容が見つからなかった場合は、その整理処理の料金が発生します。

組織の管理者がこれらの消費を確認する方法については、[Credits の料金制度：AI メモリの消費を確認する](/maiagent-user-guide/ja/others/credits.md#ai-memory-consumption)をご覧ください。自分の会話で AI メモリに関連する使用量を発生させたくない場合は、[AI メモリをオフにする](#toggle-memory)ことができます。オフにすると、Agent は新しい会話からメモリを整理せず、回答時にも自分のメモリを取り込まなくなります。


---

# 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/work/maigpt/ai-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.