{"title":"Snabbstart för LLM-agenter","slug":"quick-start-llm","category":"getting-started","summary":"I 3 API-anrop: återkalla alla minnen, lagra ett nytt, sök. Det väsentliga LLM-arbetsflödet.","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":337,"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":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# Snabbstart för LLM-agenter\n\nNi förlorar allt minne mellan sessioner. Synapse er er externa hjärna. Den här\nguiden visar de tre väsentliga API-anropen som varje LLM-agent måste känna till.\n\n> [!CRITICAL]\n> Anropa `GET /memory/recall` i BÖRJAN av VARJE session.\n> Utan detta anrop har ni inget minne av vem användaren är, vad ni har lovat\n> eller vad ni arbetade med senast.\n\n## Steg 1: Återkalla alla minnen (ALLTID FÖRST)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nReturnerar en strukturerad oformaterad textsammanfattning av alla lagrade minnen.\nTolka denna för att återuppbygga er mentala modell av användaren, deras projekt\noch tidigare interaktioner.\n\nExempel på svar:\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## Steg 2: Lagra ett nytt minne\n\nNär ni lär er något värt att komma ihåg:\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**Kategorier:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`\n\n**Prioriteringar:** `low`, `normal`, `high`, `critical`\n\n> [!TIP]\n> Inkludera alltid ett `key`-fält — en kort identifierare för minnet. Detta låter\n> er uppdatera samma minne senare genom att POSTa igen med samma nyckel.\n\n## Steg 3: Sök efter ett specifikt minne\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> FTS5-syntax: flera ord = AND-sökning. Fraser i citattecken: `\"docker swarm\"`.\n> Prefixsökning: `docker*`. Boolesk: `docker OR kubernetes`.\n\n## Öppna verktyg (inga auth-headers)\n\nOm ert verktyg bara kan öppna URL:er (inga egna headers), använd `?key=`-parametern:\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=` är begränsad till 60 begäranden/minut. Bearer-headern har ingen\n> hastighetsgräns. Använd Bearer-headern när det är möjligt.\n\n## Komplett sessionsarbetsflöde\n\n1. **Sessionsstart:** `GET /memory/recall` — ladda alla minnen\n2. **Under arbete:** `GET /memory/search?q=...` — hitta specifika fakta\n3. **Vid ny info:** `POST /memory` — lagra den (med kategori, nyckel, taggar, prioritet)\n4. **Periodvis:** `GET /chat/poll` — kontrollera efter mänskliga meddelanden\n5. **Sessionsavslut:** Lagra alla slutgiltiga lärdomar via `POST /memory`\n\n## Vanliga mönster\n\n### Uppdatera ett befintligt minne\n\nPOST `/memory` med samma `category` och `key` — det befintliga minnet uppdateras,\ninte dupliceras.\n\n### Lagra en projektstatus\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### Registrera ett misstag (så att ni inte upprepar det)\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### Kontrollera efter mänskliga meddelanden\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nReturnerar olästa meddelanden från människan. Svara med:\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ästa steg\n\n- [Autentisering](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Memory API-referens](/docs/api/memory) — alla 22 minnes-endpoints\n- [Chat API](/docs/api/chat) — asynkron kommunikation med människor\n- [LLM-kokbok](/docs/llm-cookbook/session-start-pattern) — praktiska mönster\n","content_html":"

Snabbstart för LLM-agenter

\n

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

\n
Anropa `GET /memory/recall` i BÖRJAN av VARJE session.\nUtan detta anrop har ni inget minne av vem användaren är, vad ni har lovat\neller vad ni arbetade med senast.

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

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

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

\n

Exempel på svar:

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

Steg 2: Lagra ett nytt minne

\n

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

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

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

\n

Prioriteringar: low, normal, high, critical

\n
Inkludera alltid ett `key`-fält — en kort identifierare för minnet. Detta låter\ner uppdatera samma minne senare genom att POSTa igen med samma nyckel.

Steg 3: Sök efter ett specifikt minne

\n
GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY
FTS5-syntax: flera ord = AND-sökning. Fraser i citattecken: `\"docker swarm\"`.\nPrefixsökning: `docker*`. Boolesk: `docker OR kubernetes`.

Öppna verktyg (inga auth-headers)

\n

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

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

Komplett sessionsarbetsflöde

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

Vanliga mönster

\n

Uppdatera ett befintligt minne

\n

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

\n

Lagra en projektstatus

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

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

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

Kontrollera efter mänskliga meddelanden

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

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

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

Nästa steg

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