AI メモリバンクの使い方
NOTE
本記事の翻訳作業はまだ完了していません。 中国語版原文は 中文版 を参照してください。
AI メモリバンクは MBAgent がセッション横断で保存する 長期記憶 です。AI にあなたの好み・アカウント情報・業務ルールを記憶させ、新しいセッションごとに毎回説明し直す必要がなくなります。
NOTE
スクリーンショット説明：AI メモリバンク管理画面のスクリーンショットは v1.x で随時補充予定。
一、AI 記憶とは？
MBAgent は 2 種類の「記憶」を区別します：
| タイプ | 範囲 | 用途 |
|---|---|---|
| セッション級記憶 | 現在の対話のみ | 「さっきの数字」を AI は覚えている |
| AI ローカル記憶バンク | セッション横断・永久 | あなたの好み、アカウント、業務ルール |
TIP
類比：セッション級記憶は「今回の対話の一時記憶」、AI ローカル記憶バンクは「あなたの個人档案」。
二、AI メモリバンクに保存できるもの
適する内容：
- ✅ あなたの好み（「返答スタイルはフォーマル・厳密、絵文字なし」）
- ✅ アカウント情報（「私の候鳥メインアカウントは 123456」）
- ✅ 業務ルール（「顧客 ID は常に 32 桁文字列」）
- ✅ 重要事実（「当社は主に欧米市場向け」）
- ✅ 常用用語（「GMV = Gross Merchandise Value」）
適さない内容：
- ❌ 一時情報（「今日の注文は 100」）
- ❌ 機密資格情報（パスワード・Token・API Key）→ これらは資格情報マネージャーで管理
- ❌ 大量文書 → これらは KMS 知識ベースで管理
三、AI メモリバンクの保存場所
メモリバンクファイルは MBAgent ユーザー設定ディレクトリに保存：
%LOCALAPPDATA%\mbagent\memory\
├── user.md ← ユーザー級記憶（全セッション共有）
├── project\
│ ├── my-project.md ← プロジェクト級記憶（現在のプロジェクトのみ可視）
│ └── ...- ユーザー級記憶：すべてのワークスペース・全セッション共有
- プロジェクト級記憶：現在のワークスペース（プロジェクトディレクトリ）のセッションのみ可視
四、記憶の追加
方法 1：対話で直接 AI に記憶させる
最も自然な追加方法：
ユーザー：私の候鳥メインアカウントは 123456789、主に欧米 Amazon 市場向け、と覚えてください。
MBAgent：承知しました、AI ローカル記憶バンクに追加しました。
AI が自動的に記憶する価値があるかを判断します。
方法 2：メモリバンク管理画面で手動追加
- 左サイドバーの 「AI ローカル記憶バンク」 入口をクリック
- 「+」 ボタンをクリック
- 記憶タイプを選択（ユーザー級 / プロジェクト級）
- タイトルと内容を入力
- 「保存」 をクリック
方法 3：slash command 使用
チャット入力ボックスで：
/memory add 私の候鳥メインアカウントは 123456789AI が自動的に適切な記憶カテゴリに分類します。
方法 4：対話からの蒸留
- チャット内で有用な情報を見つける
- 右クリック → 「記憶に追加」
- 記憶タイプを選択（ユーザー級 / プロジェクト級）
- 保存
五、記憶タイプと分類
AI メモリバンクは複数の分類をサポートし、管理しやすい：
| タイプ | 用途 | 例 |
|---|---|---|
| アカウント情報 | 候鳥アカウント、API Key 番号（実 Key は除く） | 「メインアカウント 123456」 |
| 業務ルール | ワークフロー、命名規則 | 「顧客 ID は 32 桁」 |
| 好み設定 | 文章スタイル、返答フォーマット | 「返答はフォーマル厳密に」 |
| 重要事実 | 業務背景、会社情報 | 「主営は欧米 Amazon」 |
| 常用用語 | 専門語彙 | 「GMV = 総取引額」 |
| その他 | 上記以外のカテゴリ | 「API ゲートウェイドメイン」 |
六、記憶の表示と編集
すべての記憶を表示
- 左サイドバー 「AI ローカル記憶バンク」 をクリック
- メモリブラウザがポップアップし、すべての記憶エントリを表示
- 分類でフィルタ、時間順に並べ替え
記憶編集
- メモリリスト内の任意の 1 つをクリック
- 右側に編集パネルが表示
- タイトル・内容・分類を修正
- 「保存」 をクリック
記憶削除
- 削除したい記憶を選択
- 「削除」 ボタンをクリック
- 削除を確認（復元不可）
TIP
定期整理：毎月 1 回メモリバンクを整理し、時代遅れや誤った情報を削除することを推奨。
七、AI は記憶をどう使う？
自動検索
新しいセッション開始時、MBAgent は 自動的に AI メモリバンクから現在のタスクに関連する記憶を検索し、system prompt の一部として含めます。
例：「私のメインアカウントの本日の注文は？」と聞いた場合：
- AI が自動的に「メインアカウント 123456」の記憶を検索
- 自動的に候鳥ブラウザ API を呼び出して 123456 の本日の注文を照会
- 「私のメインアカウントは 123456」と繰り返す必要なし
主体的に引用
AI は返答時に「覚えている」情報を明示的に言及：
「前に記録した好みによると、フォーマル厳密なスタイルで返答します。」
学習蒸留
autoLearn 設定を有効にすると、MBAgent は自動的に「意味のある対話」を記憶として蒸留：
- 「設定 → 好み」 に入る
- 「autoLearn」 オプションを見つける
- 有効化後、MBAgent が各対話を分析
- 「記憶する価値のある」ものを自動的に
self_learnメモリバンクに追加（あなたの能動的記憶とは別）
八、メモリバンクのベストプラクティス
推奨
✅ MBAgent 初回使用時に重要記憶を数件作成：
- あなたの候鳥メインアカウント番号
- 主営業務範囲
- 返答スタイルの好み
✅ AI が同じ質問を繰り返す場合、即座に記録：
- AI が「あなたの顧客 ID は何ですか」と繰り返すなら、それを記録
✅ プロジェクトごとに記憶範囲を使い分け：
- プロジェクト A の記憶はプロジェクト A のディレクトリにのみ配置
- ユーザー級記憶は一般情報を配置
✅ 記憶には構造を持たせる：
- タイトルを明確に
- 内容は簡潔に
- markdown リストで整理
反パターン
❌ 機密資格情報をメモリバンクに置かない：
- パスワード・Token・API Key は資格情報マネージャーで管理
- メモリバンクファイルは平文、暗号化なし
❌ 文書全体をメモリバンクに詰め込まない：
- 文書・参考資料は KMS 知識ベースで管理
- メモリバンクは「ルール・好み・重要事実」のみ
❌ メモリバンクを過度に膨張させない：
- 記憶が多すぎると AI の注意が薄まる
- 記憶エントリを < 50 件に維持
九、メモリバンク vs 他の機能
| 機能 | 用途 | サイズ |
|---|---|---|
| AI メモリバンク | 好み、ルール、重要事実 | 小（KB 級） |
| ローカル知識ベース（KMS） | 完全文書、参考資料 | 大（MB 級） |
| セッション | 1 回の対話の完全履歴 | 中（KB-MB 級） |
| RAG 候鳥公式知識ベース | 候鳥業務リモート検索 | リモート |
TIP
どれを選ぶ：
- シンプル好み → AI メモリバンク
- 完全文書 → KMS
- ワンショット Q&A → セッション
- 候鳥業務知識 → 候鳥 RAG
十、メモリバンクの障害切り分け
Q1：AI が前の発言を「覚えていない」ように見える
考えられる原因：
- メモリバンクへの保存に失敗
- 記憶がデフォルトで無視された（現在のタスクと無関係）
- メモリバンクファイルが破損
切り分け：
- 「AI ローカル記憶バンク」 に入って記憶が存在するか確認
- AI に再記憶させ、明示的に確認
Q2：AI が誤った記憶を使った
考えられる原因：
- 記憶分類が誤り（ユーザー級がプロジェクト級に置かれている）
- 記憶内容が古い
切り分け：
- その記憶を編集
- 修正または削除
Q3：メモリバンクをバックアップするには？
- メモリバンクディレクトリ
%LOCALAPPDATA%\mbagent\memory\を見つける - フォルダ全体をバックアップ位置にコピー
- 復元時は逆操作
Q4：複数 PC 間で記憶を同期できる？
✅ 可能ですが手動で：
- PC A で記憶をエクスポート（バックアップフォルダ）
- PC B にインポート（フォルダを上書き）
- MBAgent を再起動
NOTE
候鳥はまだクラウド記憶同期サービスを提供していません。重要記憶は手動バックアップを推奨。
下一步：中文版原文