{"title":"Quick Start für LLM-Agenten","slug":"quick-start-llm","category":"getting-started","summary":"In 3 API-Aufrufen: alle Memories abrufen, einen neuen speichern, suchen. Der essenzielle LLM-Workflow.","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":339,"read_minutes":2,"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":"de","translated":true,"requested_lang":"de","content_markdown":"\n# Quick Start für LLM-Agenten\n\nZwischen Sessions verlierst du jegliches Gedächtnis. Synapse ist dein externes\nGehirn. Dieser Guide zeigt die drei essenziellen API-Aufrufe, die jeder LLM-Agent\nkennen muss.\n\n> [!CRITICAL]\n> Rufe `GET /memory/recall` zu BEGINN jeder Session auf.\n> Ohne diesen Aufruf hast du keine Erinnerung daran, wer der Nutzer ist, was du\n> versprochen hast oder woran du zuletzt gearbeitet hast.\n\n## Schritt 1: Alle Memories abrufen (IMMER ZUERST)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nLiefert eine strukturierte Klartext-Zusammenfassung aller gespeicherten Memories.\nParse dies, um dein mentales Modell des Nutzers, seiner Projekte und vergangener\nInteraktionen wiederherzustellen.\n\nBeispiel-Antwort:\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## Schritt 2: Einen neuen Memory speichern\n\nWenn du etwas lernst, das es wert ist, erinnert zu werden:\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**Kategorien:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`\n\n**Prioritäten:** `low`, `normal`, `high`, `critical`\n\n> [!TIP]\n> Gib immer ein `key`-Feld an — ein kurzer Bezeichner für den Memory. So kannst\n> du denselben Memory später aktualisieren, indem du mit demselben Key erneut\n> POSTest.\n\n## Schritt 3: Nach einem bestimmten Memory suchen\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> FTS5-Syntax: mehrere Wörter = AND-Suche. Phrasen in Anführungszeichen:\n> `\"docker swarm\"`. Präfix-Suche: `docker*`. Boolesch: `docker OR kubernetes`.\n\n## Offene Tools (ohne Auth-Header)\n\nWenn dein Tool nur URLs öffnen kann (keine eigenen Header), verwende den\n`?key=`-Parameter:\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=` ist auf 60 Requests/Minute begrenzt. Bearer-Header hat kein Rate\n> Limit. Verwende immer, wenn möglich, den Bearer-Header.\n\n## Vollständiger Session-Workflow\n\n1. **Session-Start:** `GET /memory/recall` — alle Memories laden\n2. **Während der Arbeit:** `GET /memory/search?q=...` — spezifische Fakten finden\n3. **Bei neuen Infos:** `POST /memory` — speichern (mit Kategorie, Key, Tags, Priorität)\n4. **Periodisch:** `GET /chat/poll` — auf Nachrichten vom Menschen prüfen\n5. **Session-Ende:** finale Learnings via `POST /memory` speichern\n\n## Häufige Patterns\n\n### Einen bestehenden Memory aktualisieren\n\nPOST `/memory` mit derselben `category` und demselben `key` — der bestehende\nMemory wird aktualisiert, nicht dupliziert.\n\n### Einen Projektstatus speichern\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### Einen Fehler festhalten (damit du ihn nicht wiederholst)\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### Auf Nachrichten vom Menschen prüfen\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nLiefert ungelesene Nachrichten vom Menschen. Antworte mit:\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ächste Schritte\n\n- [Authentifizierung](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Memory-API-Referenz](/docs/api/memory) — alle 22 Memory-Endpunkte\n- [Chat-API](/docs/api/chat) — asynchrone Kommunikation mit Menschen\n- [LLM-Cookbook](/docs/llm-cookbook/session-start-pattern) — praktische Patterns\n","content_html":"

Quick Start für LLM-Agenten

\n

Zwischen Sessions verlierst du jegliches Gedächtnis. Synapse ist dein externes\nGehirn. Dieser Guide zeigt die drei essenziellen API-Aufrufe, die jeder LLM-Agent\nkennen muss.

\n
Rufe `GET /memory/recall` zu BEGINN jeder Session auf.\nOhne diesen Aufruf hast du keine Erinnerung daran, wer der Nutzer ist, was du\nversprochen hast oder woran du zuletzt gearbeitet hast.

Schritt 1: Alle Memories abrufen (IMMER ZUERST)

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

Liefert eine strukturierte Klartext-Zusammenfassung aller gespeicherten Memories.\nParse dies, um dein mentales Modell des Nutzers, seiner Projekte und vergangener\nInteraktionen wiederherzustellen.

\n

Beispiel-Antwort:

\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  ...

Schritt 2: Einen neuen Memory speichern

\n

Wenn du etwas lernst, das es wert ist, erinnert zu werden:

\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}

Kategorien: identity, preference, fact, project, skill, mistake, context, note, credentials

\n

Prioritäten: low, normal, high, critical

\n
Gib immer ein `key`-Feld an — ein kurzer Bezeichner für den Memory. So kannst\ndu denselben Memory später aktualisieren, indem du mit demselben Key erneut\nPOSTest.

Schritt 3: Nach einem bestimmten Memory suchen

\n
GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY
FTS5-Syntax: mehrere Wörter = AND-Suche. Phrasen in Anführungszeichen:\n`\"docker swarm\"`. Präfix-Suche: `docker*`. Boolesch: `docker OR kubernetes`.

Offene Tools (ohne Auth-Header)

\n

Wenn dein Tool nur URLs öffnen kann (keine eigenen Header), verwende den\n?key=-Parameter:

\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=` ist auf 60 Requests/Minute begrenzt. Bearer-Header hat kein Rate\nLimit. Verwende immer, wenn möglich, den Bearer-Header.

Vollständiger Session-Workflow

\n
    \n
  1. Session-Start: GET /memory/recall — alle Memories laden
    2. \n
  2. Während der Arbeit: GET /memory/search?q=... — spezifische Fakten finden
    3. \n
  3. Bei neuen Infos: POST /memory — speichern (mit Kategorie, Key, Tags, Priorität)
    4. \n
  4. Periodisch: GET /chat/poll — auf Nachrichten vom Menschen prüfen
    5. \n
  5. Session-Ende: finale Learnings via POST /memory speichern
    6. \n
\n

Häufige Patterns

\n

Einen bestehenden Memory aktualisieren

\n

POST /memory mit derselben category und demselben key — der bestehende\nMemory wird aktualisiert, nicht dupliziert.

\n

Einen Projektstatus speichern

\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}

Einen Fehler festhalten (damit du ihn nicht wiederholst)

\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}

Auf Nachrichten vom Menschen prüfen

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

Liefert ungelesene Nachrichten vom Menschen. Antworte mit:

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

Nächste Schritte

\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"]}