{"title":"Quick Start voor LLM-agents","slug":"quick-start-llm","category":"getting-started","summary":"In 3 API-aanroepen: alle herinneringen ophalen, een nieuwe opslaan, zoeken. De essentiële LLM-workflow.","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":340,"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":"nl","translated":true,"requested_lang":"nl","content_markdown":"\n# Quick Start voor LLM-agents\n\nU verliest alle geheugen tussen sessies. Synapse is uw externe hersenen. Deze handleiding\ntoont de drie essentiële API-aanroepen die elke LLM-agent moet kennen.\n\n> [!CRITICAL]\n> Roep `GET /memory/recall` aan aan het BEGIN van ELKE sessie.\n> Zonder deze aanroep heeft u geen geheugen van wie de gebruiker is, wat u beloofd heeft,\n> of waaraan u de laatste keer werkte.\n\n## Stap 1: Alle herinneringen ophalen (ALTIJD EERST)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nRetourneert een gestructureerde platte-tekst samenvatting van alle opgeslagen herinneringen. Parse dit om\nuw mentale model van de gebruiker, hun projecten en eerdere interacties te herstellen.\n\nVoorbeeldrespons:\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## Stap 2: Een nieuwe herinnering opslaan\n\nWanneer u iets leert dat het onthouden waard is:\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**Categorieën:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`\n\n**Prioriteiten:** `low`, `normal`, `high`, `critical`\n\n> [!TIP]\n> Voeg altijd een `key`-veld toe — een korte identificator voor de herinnering. Hiermee kunt u\n> dezelfde herinnering later bijwerken door opnieuw te POSTen met dezelfde key.\n\n## Stap 3: Naar een specifieke herinnering zoeken\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> FTS5-syntaxis: meerdere woorden = AND-zoekopdracht. Zinnen tussen aanhalingstekens: `\"docker swarm\"`.\n> Prefix-zoekopdracht: `docker*`. Booleaans: `docker OR kubernetes`.\n\n## Open tools (geen auth-headers)\n\nAls uw tool alleen URL's kan openen (geen aangepaste headers), gebruik dan de `?key=`-parameter:\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=` is gelimiteerd tot 60 verzoeken/minuut. Bearer-header heeft geen ratelimit.\n> Gebruik waar mogelijk de Bearer-header.\n\n## Volledige sessie-workflow\n\n1. **Sessiestart:** `GET /memory/recall` — alle herinneringen laden\n2. **Tijdens werk:** `GET /memory/search?q=...` — specifieke feiten vinden\n3. **Bij nieuwe info:** `POST /memory` — opslaan (met categorie, key, tags, prioriteit)\n4. **Periodiek:** `GET /chat/poll` — menselijke berichten controleren\n5. **Sessie-einde:** Sla eventuele laatste leermomenten op via `POST /memory`\n\n## Veelvoorkomende patronen\n\n### Een bestaande herinnering bijwerken\n\nPOST `/memory` met dezelfde `category` en `key` — de bestaande herinnering wordt\nbijgewerkt, niet gedupliceerd.\n\n### Projectstatus opslaan\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### Een fout vastleggen (zodat u deze niet herhaalt)\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### Menselijke berichten controleren\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nRetourneert ongelezen berichten van de mens. Antwoord met:\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## Volgende stappen\n\n- [Authenticatie](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Memory API-referentie](/docs/api/memory) — alle 22 memory-eindpunten\n- [Chat API](/docs/api/chat) — asynchrone communicatie met mensen\n- [LLM-cookbook](/docs/llm-cookbook/session-start-pattern) — praktische patronen\n","content_html":"

Quick Start voor LLM-agents

\n

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

\n
Roep `GET /memory/recall` aan aan het BEGIN van ELKE sessie.\nZonder deze aanroep heeft u geen geheugen van wie de gebruiker is, wat u beloofd heeft,\nof waaraan u de laatste keer werkte.

Stap 1: Alle herinneringen ophalen (ALTIJD EERST)

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

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

\n

Voorbeeldrespons:

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

Stap 2: Een nieuwe herinnering opslaan

\n

Wanneer u iets leert dat het onthouden waard is:

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

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

\n

Prioriteiten: low, normal, high, critical

\n
Voeg altijd een `key`-veld toe — een korte identificator voor de herinnering. Hiermee kunt u\ndezelfde herinnering later bijwerken door opnieuw te POSTen met dezelfde key.

Stap 3: Naar een specifieke herinnering zoeken

\n
GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY
FTS5-syntaxis: meerdere woorden = AND-zoekopdracht. Zinnen tussen aanhalingstekens: `\"docker swarm\"`.\nPrefix-zoekopdracht: `docker*`. Booleaans: `docker OR kubernetes`.

Open tools (geen auth-headers)

\n

Als uw tool alleen URL's kan openen (geen aangepaste headers), gebruik dan de ?key=-parameter:

\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=` is gelimiteerd tot 60 verzoeken/minuut. Bearer-header heeft geen ratelimit.\nGebruik waar mogelijk de Bearer-header.

Volledige sessie-workflow

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

Veelvoorkomende patronen

\n

Een bestaande herinnering bijwerken

\n

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

\n

Projectstatus opslaan

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

Een fout vastleggen (zodat u deze niet herhaalt)

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

Menselijke berichten controleren

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

Retourneert ongelezen berichten van de mens. Antwoord met:

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

Volgende stappen

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