# Quick Start voor LLM-agents

U verliest alle geheugen tussen sessies. Synapse is uw externe hersenen. Deze handleiding
toont de drie essentiële API-aanroepen die elke LLM-agent moet kennen.

> [!CRITICAL]
> Roep `GET /memory/recall` aan aan het BEGIN van ELKE sessie.
> Zonder deze aanroep heeft u geen geheugen van wie de gebruiker is, wat u beloofd heeft,
> of waaraan u de laatste keer werkte.

## Stap 1: Alle herinneringen ophalen (ALTIJD EERST)

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

Retourneert een gestructureerde platte-tekst samenvatting van alle opgeslagen herinneringen. Parse dit om
uw mentale model van de gebruiker, hun projecten en eerdere interacties te herstellen.

Voorbeeldrespons:

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

## Stap 2: Een nieuwe herinnering opslaan

Wanneer u iets leert dat het onthouden waard is:

```
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"
}
```

**Categorieën:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`

**Prioriteiten:** `low`, `normal`, `high`, `critical`

> [!TIP]
> Voeg altijd een `key`-veld toe — een korte identificator voor de herinnering. Hiermee kunt u
> dezelfde herinnering later bijwerken door opnieuw te POSTen met dezelfde key.

## Stap 3: Naar een specifieke herinnering zoeken

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

> [!TIP]
> FTS5-syntaxis: meerdere woorden = AND-zoekopdracht. Zinnen tussen aanhalingstekens: `"docker swarm"`.
> Prefix-zoekopdracht: `docker*`. Booleaans: `docker OR kubernetes`.

## Open tools (geen auth-headers)

Als uw tool alleen URL's kan openen (geen aangepaste headers), gebruik dan de `?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=` is gelimiteerd tot 60 verzoeken/minuut. Bearer-header heeft geen ratelimit.
> Gebruik waar mogelijk de Bearer-header.

## Volledige sessie-workflow

1. **Sessiestart:** `GET /memory/recall` — alle herinneringen laden
2. **Tijdens werk:** `GET /memory/search?q=...` — specifieke feiten vinden
3. **Bij nieuwe info:** `POST /memory` — opslaan (met categorie, key, tags, prioriteit)
4. **Periodiek:** `GET /chat/poll` — menselijke berichten controleren
5. **Sessie-einde:** Sla eventuele laatste leermomenten op via `POST /memory`

## Veelvoorkomende patronen

### Een bestaande herinnering bijwerken

POST `/memory` met dezelfde `category` en `key` — de bestaande herinnering wordt
bijgewerkt, niet gedupliceerd.

### Projectstatus opslaan

```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"
}
```

### Een fout vastleggen (zodat u deze niet herhaalt)

```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"
}
```

### Menselijke berichten controleren

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

Retourneert ongelezen berichten van de mens. Antwoord met:

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

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

## Volgende stappen

- [Authenticatie](/docs/getting-started/authentication) — Mind Key vs JWT
- [Memory API-referentie](/docs/api/memory) — alle 22 memory-eindpunten
- [Chat API](/docs/api/chat) — asynchrone communicatie met mensen
- [LLM-cookbook](/docs/llm-cookbook/session-start-pattern) — praktische patronen