# Snabbstart för LLM-agenter

Ni förlorar allt minne mellan sessioner. Synapse er er externa hjärna. Den här
guiden visar de tre väsentliga API-anropen som varje LLM-agent måste känna till.

> [!CRITICAL]
> Anropa `GET /memory/recall` i BÖRJAN av VARJE session.
> Utan detta anrop har ni inget minne av vem användaren är, vad ni har lovat
> eller vad ni arbetade med senast.

## Steg 1: Återkalla alla minnen (ALLTID FÖRST)

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

Returnerar en strukturerad oformaterad textsammanfattning av alla lagrade minnen.
Tolka denna för att återuppbygga er mentala modell av användaren, deras projekt
och tidigare interaktioner.

Exempel på svar:

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

## Steg 2: Lagra ett nytt minne

När ni lär er något värt att komma ihåg:

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

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

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

> [!TIP]
> Inkludera alltid ett `key`-fält — en kort identifierare för minnet. Detta låter
> er uppdatera samma minne senare genom att POSTa igen med samma nyckel.

## Steg 3: Sök efter ett specifikt minne

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

> [!TIP]
> FTS5-syntax: flera ord = AND-sökning. Fraser i citattecken: `"docker swarm"`.
> Prefixsökning: `docker*`. Boolesk: `docker OR kubernetes`.

## Öppna verktyg (inga auth-headers)

Om ert verktyg bara kan öppna URL:er (inga egna headers), använd `?key=`-parametern:

```
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=` är begränsad till 60 begäranden/minut. Bearer-headern har ingen
> hastighetsgräns. Använd Bearer-headern när det är möjligt.

## Komplett sessionsarbetsflöde

1. **Sessionsstart:** `GET /memory/recall` — ladda alla minnen
2. **Under arbete:** `GET /memory/search?q=...` — hitta specifika fakta
3. **Vid ny info:** `POST /memory` — lagra den (med kategori, nyckel, taggar, prioritet)
4. **Periodvis:** `GET /chat/poll` — kontrollera efter mänskliga meddelanden
5. **Sessionsavslut:** Lagra alla slutgiltiga lärdomar via `POST /memory`

## Vanliga mönster

### Uppdatera ett befintligt minne

POST `/memory` med samma `category` och `key` — det befintliga minnet uppdateras,
inte dupliceras.

### Lagra en projektstatus

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

### Registrera ett misstag (så att ni inte upprepar det)

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

### Kontrollera efter mänskliga meddelanden

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

Returnerar olästa meddelanden från människan. Svara med:

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

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

## Nästa steg

- [Autentisering](/docs/getting-started/authentication) — Mind Key vs JWT
- [Memory API-referens](/docs/api/memory) — alla 22 minnes-endpoints
- [Chat API](/docs/api/chat) — asynkron kommunikation med människor
- [LLM-kokbok](/docs/llm-cookbook/session-start-pattern) — praktiska mönster