# メモリのベストプラクティス
SUMMARY: 効果的な再取得のためのメモリ構造化 — カテゴリ、キー、タグ、優先度。

メモリのベストプラクティス
メモリの構造化方法が有用性を決定します。本ガイドでは、LLM が適切な時に適切な情報を再取得できるよう、メモリのカテゴリ化、タグ付け、優先度付けのパターンを説明します。
カテゴリ：最も具体的なものを選ぶ
| カテゴリ | 用途 | 例 |
|----------|---------|---------|
|  | ユーザー名、役割、連絡先情報 |  |
|  | 好き嫌い、作業スタイル |  |
|  | 検証可能な事実 |  |
|  | プロジェクトのステータス、決定 |  |
|  | ユーザーのスキル |  |
|  | 避けるべき過去のエラー |  |
|  | セッション関連のコンテキスト |  |
|  | その他のメモ |  |
> [!TIP]
> 迷ったら、検証可能な情報には  を、それ以外には  を使用してください。カテゴリ化しすぎず — 混乱する  より明確な  の方が良いです。
キー：意味のある識別子
 フィールドはメモリの識別子です。意味のある安定したキーを使用してください。
良いキー：
- 
- 
- 
- 
悪いキー：
- （意味がない）
- （説明的でない）
- （日付は再取得に役立たない）
キーの命名規則
- （小文字とアンダースコア）
- カテゴリをプレフィックスに：、、
- 動詞ではなく説明的な名詞を使用
- 50 文字以内に収める
タグ：検索とフィルタリング用
タグにより高速なフィルタリングと検索が可能です。メモリごとに 2〜5 個のタグを追加してください。
[CODE BLOCK]
タグのパターン
- プロジェクト名：、、
- トピック：、、、
- ステータス：、、
- 優先度指標：、
> [!NOTE]
> タグは大文字小文字を区別しません。一貫性のために小文字を使用してください。
優先度：現実的に
| 優先度 | 用途 | メモリの割合 |
|----------|---------|---------------|
|  | ユーザー ID、法的情報、不可逆な決定 | 約 5% |
|  | 進行中のプロジェクト、重要な設定 | 約 20% |
|  | ほとんどの事実、メモ、コンテキスト | 約 65% |
|  | 一時的、知っておくとよいこと | 約 10% |
> [!WARNING]
> すべてを  にしないでください。すべてが critical なら、何も critical ではありません。 は忘れた場合に実害が出るものに予約してください。
保存すべきか否か
常に保存
- ユーザー ID（名前、メール、役割）
- 長期的な設定
- プロジェクトの決定と根拠
- 過去の過ちと学んだ教訓
- ユーザーへの約束
保存しない
- 一時的な状態（変数を使用）
- 逐語的な会話履歴（チャットシステムが処理）
- 機密データ（パスワード、API キー）
- 容易に導出できる事実（現在日付、ファイル内容）
- 一時的なコンテキスト（ カテゴリ + low 優先度を使用）
メモリの更新
同じ  +  で  を呼ぶと既存メモリが更新されます。
[CODE BLOCK]
> [!TIP]
> 重複を作らずに更新できるよう、安定したキーを使用してください。LLM は情報が変わるたびに新しいメモリを作るのではなく、同じキーで再 POST すべきです。
メモリのライフサイクル
[CODE BLOCK]
- Create：完全なコンテキスト付きで POST /memory
- Active：頻繁に再取得、必要に応じて更新
- Stale：まだ関連するが活発に使用されていない（優先度を下げる？）
- Archive：優先度を  に設定、歴史的参照用に保持
- Delete：関連しなくなったら DELETE /memory/:id
定期的なクリーンアップ
[CODE BLOCK]
パターン：メモリの継承
階層的コンテキスト（プロジェクト → サブプロジェクト → タスク）向け：
[CODE BLOCK]
LLM は  で検索し、関連する全メモリを見つけられます。
パターン：決定ログ
LLM が再考しないよう、決定を根拠と共に保存します。
[CODE BLOCK]
パターン：過ちの回避
具体的な回避指示と共に過ちを保存します。
[CODE BLOCK]
避けるべきアンチパターン
> [!WARNING]
> - 会話ログの保存 — チャットシステムが処理
> - ファイル全体の保存 — スクリプトストアや外部ストレージを使用
> - 一時的な状態の保存 — 変数を使用
> - シークレットの保存 — 環境変数を使用
> - メモリの重複 — 安定したキーを使用
> - タグの過剰使用 — メモリごとに 2〜5 個が理想
> - すべてが critical — 優先度は現実的に
次のステップ
- Memory API
- Persistent LLM Agent
- Memory Tagging Strategy