Skip to main content

Snabbstart för LLM-agenter

I 3 API-anrop: återkalla alla minnen, lagra ett nytt, sök. Det väsentliga LLM-arbetsflödet.


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.

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

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

{
  "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)

{
  "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