# LLM エージェント向けクイックスタート
SUMMARY: 3 つの API 呼び出しで：全メモリの再取得、新規保存、検索。LLM の必須ワークフロー。

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query)
ALWAYS call /memory/recall at the start of every session.
Wichtigste Befehle: GET /memory/recall, POST /memory, GET /memory/search?q=...
Categories: identity, preference, fact, project, skill, mistake, context, note, credentials
Priorities: low, normal, high, critical
FTS5 search: multiple words = AND, "phrases" in quotes, prefix* for prefix search

LLM エージェント向けクイックスタート
セッション間ですべてのメモリを失います。Synapse はあなたの外部脳です。本ガイドはすべての LLM エージェントが知っておくべき 3 つの必須 API 呼び出しを示します。
> [!CRITICAL]
> 毎セッションの開始時に  を呼び出してください。
> これを呼び出さないと、ユーザーが誰か、何を約束したか、前回何を作業していたかの記憶がありません。
ステップ 1：全メモリの再取得（常に最初に）
[CODE BLOCK]
保存された全メモリの構造化されたプレーンテキスト要約を返します。これを解析して、ユーザー、プロジェクト、過去のやり取りのメンタルモデルを再構築します。
レスポンス例：
[CODE BLOCK]
ステップ 2：新規メモリの保存
記憶する価値のあることを学んだら：
[CODE BLOCK]
カテゴリ： 、、、、、、、
優先度： 、、、
> [!TIP]
> 常に  フィールドを含めてください — メモリの短い識別子です。同じキーで再 POST することで、後から同じメモリを更新できます。
ステップ 3：特定メモリの検索
[CODE BLOCK]
> [!TIP]
> FTS5 構文：複数単語 = AND 検索。フレーズは引用符：。プレフィックス検索：。ブール：。
オープンツール（認証ヘッダーなし）
ツールが URL しか開けない場合（カスタムヘッダーなし）、 パラメータを使用します。
[CODE BLOCK]
> [!WARNING]
>  は 60 リクエスト/分にレート制限されます。Bearer ヘッダーにはレート制限がありません。可能な限り Bearer ヘッダーを使用してください。
完全なセッションワークフロー
1. セッション開始：  — 全メモリを読み込む
2. 作業中：  — 特定の事実を検索
3. 新情報：  — 保存（category、key、tags、priority を指定）
4. 定期的に：  — 人間のメッセージを確認
5. セッション終了： 最終的な学習内容を  で保存
よくあるパターン
既存メモリの更新
同じ  と  で  を呼び出すと、重複ではなく既存メモリが更新されます。
プロジェクトステータスの保存
[CODE BLOCK]
過ちの記録（繰り返しを避けるため）
[CODE BLOCK]
人間のメッセージの確認
[CODE BLOCK]
人間からの未読メッセージを返します。以下で返信：
[CODE BLOCK]
次のステップ
- Authentication — Mind Key vs JWT
- Memory API reference — 22 のメモリエンドポイントすべて
- Chat API — 人間との非同期通信
- LLM Cookbook — 実践的パターン