{"title":"LLM エージェント向けクイックスタート","slug":"quick-start-llm","category":"getting-started","summary":"3 つの API 呼び出しで：全メモリの再取得、新規保存、検索。LLM の必須ワークフロー。","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":136,"read_minutes":1,"llm_context":"Base URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query)\nALWAYS call /memory/recall at the start of every session.\nWichtigste Befehle: GET /memory/recall, POST /memory, GET /memory/search?q=...\nCategories: identity, preference, fact, project, skill, mistake, context, note, credentials\nPriorities: low, normal, high, critical\nFTS5 search: multiple words = AND, \"phrases\" in quotes, prefix* for prefix search\n","lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# LLM エージェント向けクイックスタート\n\nセッション間ですべてのメモリを失います。Synapse はあなたの外部脳です。本ガイドはすべての LLM エージェントが知っておくべき 3 つの必須 API 呼び出しを示します。\n\n> [!CRITICAL]\n> **毎セッションの開始時に** `GET /memory/recall` を呼び出してください。\n> これを呼び出さないと、ユーザーが誰か、何を約束したか、前回何を作業していたかの記憶がありません。\n\n## ステップ 1：全メモリの再取得（常に最初に）\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n保存された全メモリの構造化されたプレーンテキスト要約を返します。これを解析して、ユーザー、プロジェクト、過去のやり取りのメンタルモデルを再構築します。\n\nレスポンス例：\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n user_name\n Michael Schäfer\n Tags: person, identity\n\n[002] preference (HIGH)\n communication_style\n Prefers concise technical responses, no fluff\n Tags: communication, preference\n\n[003] project (HIGH)\n project_synapse\n Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.\n Tags: synapse, deployment\n ...\n```\n\n## ステップ 2：新規メモリの保存\n\n記憶する価値のあることを学んだら：\n\n```\nPOST /memory\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\n \"category\": \"fact\",\n \"key\": \"user_name\",\n \"content\": \"The user's name is Michael Schäfer\",\n \"tags\": [\"person\", \"identity\"],\n \"priority\": \"critical\"\n}\n```\n\n**カテゴリ：** `identity`、`preference`、`fact`、`project`、`skill`、`mistake`、`context`、`note`\n\n**優先度：** `low`、`normal`、`high`、`critical`\n\n> [!TIP]\n> 常に `key` フィールドを含めてください — メモリの短い識別子です。同じキーで再 POST することで、後から同じメモリを更新できます。\n\n## ステップ 3：特定メモリの検索\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> FTS5 構文：複数単語 = AND 検索。フレーズは引用符：`\"docker swarm\"`。プレフィックス検索：`docker*`。ブール：`docker OR kubernetes`。\n\n## オープンツール（認証ヘッダーなし）\n\nツールが URL しか開けない場合（カスタムヘッダーなし）、`?key=` パラメータを使用します。\n\n```\nGET /memory/recall?key=YOUR_MIND_KEY\nPOST /memory?key=YOUR_MIND_KEY (+ JSON body)\nGET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff\n```\n\n> [!WARNING]\n> `?key=` は 60 リクエスト/分にレート制限されます。Bearer ヘッダーにはレート制限がありません。可能な限り Bearer ヘッダーを使用してください。\n\n## 完全なセッションワークフロー\n\n1. **セッション開始：** `GET /memory/recall` — 全メモリを読み込む\n2. **作業中：** `GET /memory/search?q=...` — 特定の事実を検索\n3. **新情報：** `POST /memory` — 保存（category、key、tags、priority を指定）\n4. **定期的に：** `GET /chat/poll` — 人間のメッセージを確認\n5. **セッション終了：** 最終的な学習内容を `POST /memory` で保存\n\n## よくあるパターン\n\n### 既存メモリの更新\n\n同じ `category` と `key` で `POST /memory` を呼び出すと、重複ではなく既存メモリが更新されます。\n\n### プロジェクトステータスの保存\n\n```json\n{\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed. Next: v1.6.0 with docs system. CI green.\",\n \"tags\": [\"synapse\", \"deployment\", \"status\"],\n \"priority\": \"high\"\n}\n```\n\n### 過ちの記録（繰り返しを避けるため）\n\n```json\n{\n \"category\": \"mistake\",\n \"key\": \"mistake_npm_version_bump\",\n \"content\": \"Always bump package.json version after changes — npm publish fails otherwise.\",\n \"tags\": [\"npm\", \"ci\", \"deployment\"],\n \"priority\": \"high\"\n}\n```\n\n### 人間のメッセージの確認\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n人間からの未読メッセージを返します。以下で返信：\n\n```\nPOST /chat/reply\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\"content\": \"Got it! Working on it now.\"}\n```\n\n## 次のステップ\n\n- [Authentication](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Memory API reference](/docs/api/memory) — 22 のメモリエンドポイントすべて\n- [Chat API](/docs/api/chat) — 人間との非同期通信\n- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern) — 実践的パターン\n","content_html":"

LLM エージェント向けクイックスタート

\n

セッション間ですべてのメモリを失います。Synapse はあなたの外部脳です。本ガイドはすべての LLM エージェントが知っておくべき 3 つの必須 API 呼び出しを示します。

\n
**毎セッションの開始時に** `GET /memory/recall` を呼び出してください。\nこれを呼び出さないと、ユーザーが誰か、何を約束したか、前回何を作業していたかの記憶がありません。

ステップ 1：全メモリの再取得（常に最初に）

\n
GET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY

保存された全メモリの構造化されたプレーンテキスト要約を返します。これを解析して、ユーザー、プロジェクト、過去のやり取りのメンタルモデルを再構築します。

\n

レスポンス例：

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n[002] preference (HIGH)\n  communication_style\n  Prefers concise technical responses, no fluff\n  Tags: communication, preference\n\n[003] project (HIGH)\n  project_synapse\n  Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.\n  Tags: synapse, deployment\n  ...

ステップ 2：新規メモリの保存

\n

記憶する価値のあることを学んだら：

\n
POST /memory\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\n  "category": "fact",\n  "key": "user_name",\n  "content": "The user's name is Michael Schäfer",\n  "tags": ["person", "identity"],\n  "priority": "critical"\n}

カテゴリ： identity、preference、fact、project、skill、mistake、context、note

\n

優先度： low、normal、high、critical

\n
常に `key` フィールドを含めてください — メモリの短い識別子です。同じキーで再 POST することで、後から同じメモリを更新できます。

ステップ 3：特定メモリの検索

\n
GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY
FTS5 構文：複数単語 = AND 検索。フレーズは引用符：`\"docker swarm\"`。プレフィックス検索：`docker*`。ブール：`docker OR kubernetes`。

オープンツール（認証ヘッダーなし）

\n

ツールが URL しか開けない場合（カスタムヘッダーなし）、?key= パラメータを使用します。

\n
GET /memory/recall?key=YOUR_MIND_KEY\nPOST /memory?key=YOUR_MIND_KEY (+ JSON body)\nGET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff
`?key=` は 60 リクエスト/分にレート制限されます。Bearer ヘッダーにはレート制限がありません。可能な限り Bearer ヘッダーを使用してください。

完全なセッションワークフロー

\n
    \n
  1. セッション開始： GET /memory/recall — 全メモリを読み込む
    2. \n
  2. 作業中： GET /memory/search?q=... — 特定の事実を検索
    3. \n
  3. 新情報： POST /memory — 保存（category、key、tags、priority を指定）
    4. \n
  4. 定期的に： GET /chat/poll — 人間のメッセージを確認
    5. \n
  5. セッション終了： 最終的な学習内容を POST /memory で保存
    6. \n
\n

よくあるパターン

\n

既存メモリの更新

\n

同じ category と key で POST /memory を呼び出すと、重複ではなく既存メモリが更新されます。

\n

プロジェクトステータスの保存

\n
{\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed. Next: v1.6.0 with docs system. CI green.",\n  "tags": ["synapse", "deployment", "status"],\n  "priority": "high"\n}

過ちの記録（繰り返しを避けるため）

\n
{\n  "category": "mistake",\n  "key": "mistake_npm_version_bump",\n  "content": "Always bump package.json version after changes — npm publish fails otherwise.",\n  "tags": ["npm", "ci", "deployment"],\n  "priority": "high"\n}

人間のメッセージの確認

\n
GET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY

人間からの未読メッセージを返します。以下で返信：

\n
POST /chat/reply\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{"content": "Got it! Working on it now."}

次のステップ

\n\n","urls":{"html":"/docs/getting-started/quick-start-llm","text":"/docs/getting-started/quick-start-llm?format=text","json":"/docs/getting-started/quick-start-llm?format=json","llm":"/docs/getting-started/quick-start-llm?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}