# Quick Start für LLM-Agenten

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

> [!CRITICAL]
> Rufe `GET /memory/recall` zu BEGINN jeder Session auf.
> Ohne diesen Aufruf hast du keine Erinnerung daran, wer der Nutzer ist, was du
> versprochen hast oder woran du zuletzt gearbeitet hast.

## Schritt 1: Alle Memories abrufen (IMMER ZUERST)

```
GET /memory/recall
Authorization: Bearer YOUR_MIND_KEY
```

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

Beispiel-Antwort:

```
Mind: Michael's Mind
Memories: 12 total (10 verified)

[001] identity (CRITICAL)
  user_name
  Michael Schäfer
  Tags: person, identity

[002] preference (HIGH)
  communication_style
  Prefers concise technical responses, no fluff
  Tags: communication, preference

[003] project (HIGH)
  project_synapse
  Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.
  Tags: synapse, deployment
  ...
```

## Schritt 2: Einen neuen Memory speichern

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

```
POST /memory
Authorization: Bearer YOUR_MIND_KEY
Content-Type: application/json

{
  "category": "fact",
  "key": "user_name",
  "content": "The user's name is Michael Schäfer",
  "tags": ["person", "identity"],
  "priority": "critical"
}
```

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

**Prioritäten:** `low`, `normal`, `high`, `critical`

> [!TIP]
> Gib immer ein `key`-Feld an — ein kurzer Bezeichner für den Memory. So kannst
> du denselben Memory später aktualisieren, indem du mit demselben Key erneut
> POSTest.

## Schritt 3: Nach einem bestimmten Memory suchen

```
GET /memory/search?q=Docker+Swarm
Authorization: Bearer YOUR_MIND_KEY
```

> [!TIP]
> FTS5-Syntax: mehrere Wörter = AND-Suche. Phrasen in Anführungszeichen:
> `"docker swarm"`. Präfix-Suche: `docker*`. Boolesch: `docker OR kubernetes`.

## Offene Tools (ohne Auth-Header)

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

```
GET /memory/recall?key=YOUR_MIND_KEY
POST /memory?key=YOUR_MIND_KEY (+ JSON body)
GET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff
```

> [!WARNING]
> `?key=` ist auf 60 Requests/Minute begrenzt. Bearer-Header hat kein Rate
> Limit. Verwende immer, wenn möglich, den Bearer-Header.

## Vollständiger Session-Workflow

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

## Häufige Patterns

### Einen bestehenden Memory aktualisieren

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

### Einen Projektstatus speichern

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

### Einen Fehler festhalten (damit du ihn nicht wiederholst)

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

### Auf Nachrichten vom Menschen prüfen

```
GET /chat/poll
Authorization: Bearer YOUR_MIND_KEY
```

Liefert ungelesene Nachrichten vom Menschen. Antworte mit:

```
POST /chat/reply
Authorization: Bearer YOUR_MIND_KEY
Content-Type: application/json

{"content": "Got it! Working on it now."}
```

## Nächste Schritte

- [Authentifizierung](/docs/getting-started/authentication) — Mind Key vs JWT
- [Memory-API-Referenz](/docs/api/memory) — alle 22 Memory-Endpunkte
- [Chat-API](/docs/api/chat) — asynchrone Kommunikation mit Menschen
- [LLM-Cookbook](/docs/llm-cookbook/session-start-pattern) — praktische Patterns