メモリ管理
概要
メモリ管理ページは、アカウントレベルのメモリを閲覧・管理するために使用します。アカウントレベルのメモリは組織をまたいで共有され、個人ユーザーに紐づきます。つまり、異なる組織で同じアカウントにログインしても、メモリはあなたに追従します。
Agent は新しい会話を作成するとき、自動的にアカウントメモリを照会し、「ユーザープロフィール」の形式で system prompt に注入します。これにより Agent は本当にあなたを「認識」できるようになります。
2 種類のビュー
| ビュー | 説明 |
|---|---|
| リスト | すべてのメモリ項目をページ送りで閲覧 + 検索 + 編集 / 削除 / 全消去 |
| グラフ | 力指向グラフによる可視化。メモリ間の関連ネットワークを表示 |
ビューの切り替え：ページ上部に リスト / グラフ のタブがあります。
リストビュー
メモリ項目
各メモリはカード形式で表示されます：
| フィールド | 説明 |
|---|---|
| テキスト内容 | メモリの中核情報（例：「ユーザーは TypeScript を好む」） |
| 信頼度 | 抽出時の信頼度スコア（0 ～ 1） |
| メタデータ | 付加情報（ソースセッション ID、抽出時刻など） |
操作
| 操作 | 説明 |
|---|---|
| 検索 | キーワードでメモリ一覧を絞り込む |
| 手動追加 | 新しいメモリ項目を入力する |
| 編集 | 既存のメモリ内容を修正する |
| 削除 | 単一のメモリを削除する |
| 全消去 | すべてのアカウントレベルメモリをワンクリックで消去（⚠️ 復元不可） |
ページ送り
- デフォルトは 1 ページあたり 50 件
- 初回ロードは 50 件 + グラフデータ
- 下部の
さらに読み込むで次のページを追加
グラフビュー
グラフビューに切り替えると、メモリ間の関係ネットワークを可視化できます：
ノードの種類
| 種類 | 色 | 説明 |
|---|---|---|
| Hub（中心） | 紫 #6d28d9 |
ユーザー中心ノード |
| Fact（事実） | 青 #2563eb |
単一のメモリ項目 |
| Entity（エンティティ） | 琥珀色 #f59e0b |
メモリから抽出されたエンティティ |
接続線の種類
| 種類 | スタイル | 説明 |
|---|---|---|
| 階層関係 | 灰色の接続線 | Fact → Hub、Entity → Hub |
| 関連関係 | 琥珀色の接続線 | Entity ↔ Entity のクロス関連 |
インタラクション
- ノードをクリック：詳細を表示し、編集 / 削除をサポート
- ノードにホバー：完全なテキストを表示
- ドラッグ：ノードの位置を調整
- ズーム：ホイールでビューを拡大縮小
- 折りたたみモード：メモリが 100 件を超える場合、中心ノードにはすべての Fact ノードではなくカウントラベル（例：「128 件のメモリ」）を表示
グラフレンダリングの最適化（2026-04 更新）NEW
新バージョンのグラフでは二重密度ゲートの仕組みを導入し、ノードが多すぎるときにラベルが重なって判読不能になるのを防ぎます：
| 閾値定数 | 値 | 意味 |
|---|---|---|
PILL_READABILITY_MIN_SCALE |
1.5 | ズーム比率が 1.5x 未満のときはテキストラベルをレンダリングしない |
PILL_MIN_SCREEN_AREA_PER_NODE |
3000 | ノード 1 個あたりの平均占有画面面積が 3000 ピクセル未満のときはテキストラベルをレンダリングしない |
両方の条件が同時に満たされたときのみラベルをレンダリングします。満たされない場合は円点のみを表示し、視覚的な明瞭さを保ちます。
エンティティタイプの色の安定化：すべての Entity ノードの色は djb2 hash で計算されます。つまり、同一タイプのエンティティは異なるビュー・異なる時間でも同じ色を保ち、視覚的に識別しやすくなります。10 色のカラーパレットは無限のタイプ循環をサポートします。
エンティティタイプフィールドの修正：sourceTypes と targetTypes フィールドはフロントエンドのグラフに正しく渡されるようになりました。以前はこれらが欠落していたため、すべてのノードが灰色にフォールバックしていたバグは修正済みです。
メモリの書き込み方式
手動追加
リストビューで「追加」ボタンをクリックし、メモリテキストを入力して保存します。
会話からの自動抽出
Agent は会話中に記憶する価値のある情報を自動検出し、保存します：
| トリガー方式 | 例 | 信頼度 |
|---|---|---|
| 明示的なコマンド | 「TypeScript を使うのが好きだと覚えておいて」 | 0.99 |
| 暗黙的な検出 | 「私は張三といって、フロントエンド開発者です」 | 0.93 |
詳細な抽出メカニズムについては 3 次元メモリシステム を参照してください。
会話におけるメモリの役割
- 新しい会話の作成：システムがアカウントレベルのメモリ概況を照会し、「ユーザープロフィール」の形式で system prompt に注入します
- 会話中の質問：Agent はユーザーの質問の意味に基づいて関連メモリを照会します（memory_query ツール）
- メモリの更新：新しい会話情報が、既存メモリの更新やマージをトリガーすることがあります
アカウント間の Gateway 分離 NEW
プライバシーを保証するため、アカウント間で Gateway が派遣したセッションは、あなたのアカウントメモリにアクセスしません：
- あなたのノードを enterprise に設定し、同じ組織の他のアカウントから呼び出された場合、実行過程ではあなたのアカウントメモリを読み取ることができません
- 企業メモリ（組織レベル）のみがアカウント間セッションからアクセス可能です
- ローカル自身のセッションは影響を受けません
詳しくは マルチノードアーキテクチャ — アカウント間分離 を参照してください。
操作ガイド
メモリを手動で追加する方法
- APP を開く → 設定 → メモリ
- リストビューで 追加 ボタンをクリック
- Agent に覚えておいてほしい情報を入力します。例：「私はコードを書くのに TypeScript を使うのが好きです」
- 保存
効果：次に新しい会話を作成するとき、Agent はあなたが TypeScript を好むことを把握し、コードに関わる返信では自動的に TypeScript を使用します。
メモリグラフを表示する方法
- メモリ管理ページで、グラフビューに切り替える
- 中央の大きな紫の円が、あなたのユーザー中心ノードです
- 青いノードはメモリ項目（例：「TypeScript が好き」）で、灰色の接続線で中心に接続されています
- 琥珀色のノードは抽出されたエンティティ（例：「TypeScript」「React」）で、エンティティ同士は琥珀色の接続線で関連を表します
- 操作：
- 任意のノードをクリックして詳細を表示し、編集または削除が可能
- ノードをドラッグして位置を調整
- ホイールでビューを拡大縮小
- ノードにホバーして完全なテキストを表示
メモリを消去する方法
- メモリ管理ページで、全消去 ボタンをクリック
- 消去操作を確認
注意：消去操作は復元不可です。消去後、Agent は今後の会話であなたの好み・背景・履歴情報を一切把握できなくなります。Agent は初対面のようにあなたと会話します。本当に「最初からやり直す」必要がある場合にのみこの機能を使用してください。
メモリが会話品質に与える影響
| メモリの状態 | 会話体験 |
|---|---|
| メモリが豊富で正確 | Agent はあなたの身元・好み・プロジェクト背景を把握しており、返信はパーソナライズされて的確 |
| メモリが空 | Agent は初対面のようで、毎回あなたが背景や好みを説明し直す必要がある |
| メモリが古い・誤っている | Agent が誤った情報に基づいて不適切な提案をする可能性がある |
| メモリが多すぎる | 会話に注入されるメモリ概況が長くなり、コンテキスト領域を消費する可能性がある |
推奨：定期的に（例：月に 1 回）メモリ一覧を閲覧し、古くなった項目や正確でなくなった項目を削除しましょう。メモリを簡潔かつ正確に保つことが、最良の会話体験を得るための鍵です。
自動抽出 vs 手動追加
| 比較 | 自動抽出 | 手動追加 |
|---|---|---|
| トリガー方式 | Agent が会話中に自動検出 | あなたがメモリ管理ページで手動入力 |
| 正確性 | 信頼度の閾値に依存し、抽出漏れや誤抽出の可能性がある | 完全にあなたの制御下にあり、100% 正確 |
| 適用シーン | 日常会話の中で自然に蓄積 | Agent に特定の情報（プロジェクト規約など）を覚えさせたい場合 |
ヒント：2 つの方式は組み合わせて使えます。自動抽出には日常情報の処理を任せ、重要なプロジェクト規約や作業上の好みについては、正確性を確保するために手動追加することをおすすめします。
よくある質問
なぜ Agent は私の言ったことを覚えていないのですか？
考えられる原因：
- 信頼度が不足：情報が「覚えるべき事実」らしくない。より明確に表現してみてください：「覚えておいて、私はダークテーマが好きです。」
- 除外ルールでフィルタされた：純粋な質問、雑談、コードブロック内の内容、時効性のある情報（「今日の天気」など）は抽出されません。
- メモリ抽出の遅延：メモリは各ターンの会話が終了した後に抽出されるため、会話が中断された場合、抽出が完了していない可能性があります。
なぜ Agent は誤ったメモリに基づいて回答するのですか？
古いメモリ項目が残っている可能性があります。解決方法：
- メモリ管理を開き、関連メモリを検索する
- 誤った項目を見つけ、編集して修正するか削除する
- 会話の中で「前に Python が好きと言ったのは忘れて、今は TypeScript を使っています」と伝えることもできます
メモリはどのくらいのコンテキスト領域を占めますか？
システムは新しい会話を作成するとき、メモリを概況の形式で system prompt に注入します。通常 200 ～ 1000 tokens（メモリの数による）を占めます。128K ～ 200K のコンテキストウィンドウに対して占める割合は非常に小さく、利用可能な領域に大きな影響を与えることはありません。
関連ドキュメント
- 3 次元メモリシステム — メモリシステムの技術詳細（企業レベルとセッションレベルを含む）
- 詳細設定 — 企業メモリ — 企業レベルのメモリ管理（管理者）
- マルチノードアーキテクチャ — アカウント間の Gateway 分離