> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/advanced-basic/memory.md).

# グローバルメモリ

{% hint style="warning" %}
**機能説明**：

* **現在はアシスタント（Assistant）のみサポートしており、エージェント（Cherry Agent）はまだグローバルメモリをサポートしていません。**
* 本機能はまだ **Beta** 段階にあり、全体的な効果は限定的です。今後のバージョンで調整または提供終了となる可能性があるため、過度に依存しないでください。
  {% endhint %}

通常の会話の AI には長期記憶はありません——新しい話題を始めるたびに、自己紹介をやり直す必要があります。

**グローバルメモリ**AI に**長期記憶能力を提供し**：有効にすると、AI は**会話をまたいで**あなたに関する重要な情報（職業、好み、よく使う口調、長期的な事実など）を記憶し、新しい会話で直接呼び出せます。

> 先に [概念入門](/docs/jp/advanced-basic/concepts-101.md) メモリと他機能の関係を整理しましょう。

### 有効化前の2つの準備

グローバルメモリには2種類の作業があります：

* **記憶の理解と整理**：日常のチャットで使うのと同種の会話モデルが必要です
* **記憶の保存と検索**："埋め込みモデル"が必要です

**埋め込みモデル**の役割は**各記憶を数値ベクトルに変換することです**。AI はベクトルの類似度を比較することで、関連する記憶を素早く見つけます。この種の専用小型モデルは、サイズが小さく、高速で、呼び出しコストも低いです。

まず `設定 → モデルサービス` で少なくとも1つの Provider を設定し、 **会話モデルと埋め込みモデルをそれぞれ1つ追加してください**。CherryIN を例にすると、Provider 詳細ページで **モデル一覧を取得**をクリックし、ポップアップ上部で「埋め込み」カテゴリに切り替え、少なくとも1つ追加します（推奨 `bge-m3` または `text-embedding-3-small`）。

{% hint style="warning" %}
会話モデルだけを追加して埋め込みモデルを追加していない場合、メモリ設定は完了できません（埋め込みモデルのドロップダウンには「データなし」と表示されます）。
{% endhint %}

### グローバルメモリを有効にする

1. 開く `設定 → グローバルメモリ`
2. 右上の **グローバルメモリ** スイッチ

<figure><img src="/files/95f3d80c8ad92474c73f8537c6ba5bd79416a1ee" alt=""><figcaption><p>未有効状態：右上のグレーのスイッチ + 空状態「記憶なし」</p></figcaption></figure>

スイッチを初めてオンにすると、自動的に **メモリ設定** ダイアログが表示され、モデルの選択が求められます：

<figure><img src="/files/c694ccbded829ca057547966829f1664d1ec1211" alt=""><figcaption><p>必須項目：LLM モデル + 埋め込みモデル</p></figcaption></figure>

* **LLM モデル**：設定済みの会話モデルから任意のものを選択
* **埋め込みモデル**：追加済みの Embedding モデルから任意のものを選択
* **埋め込み次元**：空欄でも可。Embedding モデルの既定次元が自動的に決まります

入力後に **OK**をクリックします。これでシステムレベルのグローバルメモリが有効になります。

### 各アシスタントでも「さらに」1回有効にする必要があります

{% hint style="warning" %}
**多くのユーザーがここでつまずきます**：上記の手順をすべて完了しても、新しい会話で AI が依然として覚えていないように見える場合があります——グローバルメモリは**2層のスイッチ**：

1. システムレベル（先ほど完了したもの）
2. アシスタントレベル（**既定ではオフです**）を生成

各アシスタントごとに個別に有効化しないとメモリを使用できません。
{% endhint %}

手順：

1. 会話ページに入り、アシスタント一覧で対象アシスタントをクリック → 編集（またはアシスタントライブラリで新しいアシスタントを作成する際に）
2. アシスタント設定で **グローバルメモリ** スイッチを見つけてオンにする
3. その後、そのアシスタントは新しい会話で自動的にメモリ庫を読み取り更新します

よく使う「デフォルトアシスタント」で先に一度有効にしておけば、以後は手間がかかりません。

### 埋め込みモデルのドロップダウンに「データなし」と表示されたらどうするか

最もよくあるつまずきポイント：LLM モデルを選んだあと、埋め込みモデルのドロップダウンが「データなし」になります。

<figure><img src="/files/829243530355df88335d69b9ceacaffc0d6c6cd6" alt=""><figcaption><p>典型的なつまずき：LLM は選択済み（CherryIN）、埋め込みのドロップダウンは「データなし」と表示</p></figcaption></figure>

原因：あなたの Provider には選択可能な Embedding モデルがありません。対処法：

1. 現在のダイアログを閉じて（ **キャンセル**）を生成
2. へ移動 `設定 → モデルサービス → あなたの Provider`
3. をクリック **モデル一覧を取得**し、ポップアップ上部のタブを **埋め込み**
4. に切り替えて、1〜2個の埋め込みモデルを追加します（例： `bge-m3`、`text-embedding-3-small` など）
5. に戻り `設定 → グローバルメモリ`、スイッチを再度オンにする

### ユーザー管理

グローバルメモリは「ユーザー」ごとにグループ化されます。既定で `デフォルトユーザー`を1つ提供しており、家族やチームメンバーごとに独立したメモリ庫を作成することもできます：

* をクリック **ユーザー管理** 右側の +👤 アイコン → 新しいユーザー ID を入力して作成
* 異なるユーザーに切り替えると、下部の **メモリ一覧** と統計が個別に表示されます

### 記憶の追加、閲覧、削除

有効化後：

* をクリック **最初の記憶を追加する** または **+ 記憶を追加**をクリックし、ポップアップで内容を入力して保存
* で **記憶を検索…** ボックスからキーワードで絞り込み可能
* 各記憶は個別に編集または削除できます
* その他の操作メニューでは **記憶をリセット** / **ユーザー記憶をリセット**を選択でき、現在のユーザーのすべての記憶を消去します（復元不可、慎重に使用してください）

### トークン消費

グローバルメモリを有効にすると、会話ごとに追加の token を一定量消費します：

* 質問ベクトルの抽出、候補記憶の検索
* LLM による新しい記憶を書き込むかどうかの判定 + 書き込み処理

コストが気になる場合は、最もよく使う1〜2個のアシスタントだけでグローバルメモリを有効にし、他のアシスタントはオフのままにしてください。

{% hint style="info" %}
グローバルメモリは現在 Beta 段階のため、将来のバージョンで入口やフィールド名が変更される可能性があります。本ページではアプリ内に実際に表示される内容を基準にしてください。
{% endhint %}

### ヒントとコツ

* 初めて有効にした後は、 `最初の記憶を追加する` に1件 **あなた自身の概要**（職業、関心のある方向、好みの口調など）を書いておくと、以後の会話で自動的に参照されます
* 一部のアシスタントにメモリを使わせたくない場合は、そのアシスタント設定で「グローバルメモリ」を個別にオフにしてください
* 長期的に使う場合は、定期的に古い記憶を整理して、文脈の汚染を防ぐことをおすすめします

***

### 💡 ヘルプの取得とフィードバックの送信

設定や使用中に疑問、バグ、機能改善の提案がありましたら、 [フィードバックと提案](/docs/jp/question-contact/suggestions.md) に記載の公式チャネルを参照してください。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/jp/advanced-basic/memory.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.