{"title":"Démarrage rapide pour les agents LLM","slug":"quick-start-llm","category":"getting-started","summary":"En 3 appels d'API : rappeler toutes les mémoires, en stocker une nouvelle, rechercher. Le workflow LLM essentiel.","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":408,"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":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Démarrage rapide pour les agents LLM\n\nVous perdez toute mémoire entre les sessions. Synapse est votre cerveau externe. Ce\nguide présente les trois appels d'API essentiels que tout agent LLM doit connaître.\n\n> [!CRITICAL]\n> Appelez `GET /memory/recall` au DÉBUT de CHAQUE session.\n> Sans cet appel, vous n'avez aucune mémoire de qui est l'utilisateur, de ce que vous\n> avez promis, ou de ce sur quoi vous travailliez la dernière fois.\n\n## Étape 1 : rappeler toutes les mémoires (TOUJOURS EN PREMIER)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nRenvoie un résumé structuré en texte brut de toutes les mémoires stockées. Analysez-le\npour reconstruire votre modèle mental de l'utilisateur, ses projets et les\ninteractions passées.\n\nExemple de réponse :\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## Étape 2 : stocker une nouvelle mémoire\n\nQuand vous apprenez quelque chose qui mérite d'être retenu :\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**Catégories :** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`\n\n**Priorités :** `low`, `normal`, `high`, `critical`\n\n> [!TIP]\n> Incluez toujours un champ `key` — un identifiant court pour la mémoire. Cela vous\n> permet de mettre à jour la même mémoire plus tard en re-POSTant avec la même clé.\n\n## Étape 3 : rechercher une mémoire spécifique\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> Syntaxe FTS5 : plusieurs mots = recherche AND. Phrases entre guillemets :\n> `\"docker swarm\"`. Recherche par préfixe : `docker*`. Booléen : `docker OR kubernetes`.\n\n## Outils ouverts (sans en-têtes d'auth)\n\nSi votre outil ne peut qu'ouvrir des URLs (pas d'en-têtes personnalisés), utilisez le\nparamètre `?key=` :\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=` est limité à 60 requêtes/minute. L'en-tête Bearer n'a pas de limite de\n> débit. Utilisez l'en-tête Bearer chaque fois que possible.\n\n## Workflow complet de session\n\n1. **Début de session :** `GET /memory/recall` — charger toutes les mémoires\n2. **Pendant le travail :** `GET /memory/search?q=...` — trouver des faits spécifiques\n3. **Sur nouvelle info :** `POST /memory` — la stocker (avec catégorie, clé, tags, priorité)\n4. **Périodiquement :** `GET /chat/poll` — vérifier les messages humains\n5. **Fin de session :** Stocker tout apprentissage final via `POST /memory`\n\n## Schémas courants\n\n### Mettre à jour une mémoire existante\n\nPOST `/memory` avec la même `category` et `key` — la mémoire existante est mise à\njour, pas dupliquée.\n\n### Stocker un statut de projet\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### Enregistrer une erreur (pour ne pas la répéter)\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### Vérifier les messages humains\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nRenvoie les messages non lus de l'humain. Répondez avec :\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## Prochaines étapes\n\n- [Authentification](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Référence API Memory](/docs/api/memory) — tous les 22 endpoints mémoire\n- [API Chat](/docs/api/chat) — communication asynchrone avec les humains\n- [Cookbook LLM](/docs/llm-cookbook/session-start-pattern) — schémas pratiques\n","content_html":"

Démarrage rapide pour les agents LLM

\n

Vous perdez toute mémoire entre les sessions. Synapse est votre cerveau externe. Ce\nguide présente les trois appels d'API essentiels que tout agent LLM doit connaître.

\n
Appelez `GET /memory/recall` au DÉBUT de CHAQUE session.\nSans cet appel, vous n'avez aucune mémoire de qui est l'utilisateur, de ce que vous\navez promis, ou de ce sur quoi vous travailliez la dernière fois.

Étape 1 : rappeler toutes les mémoires (TOUJOURS EN PREMIER)

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

Renvoie un résumé structuré en texte brut de toutes les mémoires stockées. Analysez-le\npour reconstruire votre modèle mental de l'utilisateur, ses projets et les\ninteractions passées.

\n

Exemple de réponse :

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

Étape 2 : stocker une nouvelle mémoire

\n

Quand vous apprenez quelque chose qui mérite d'être retenu :

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

Catégories : identity, preference, fact, project, skill, mistake, context, note, credentials

\n

Priorités : low, normal, high, critical

\n
Incluez toujours un champ `key` — un identifiant court pour la mémoire. Cela vous\npermet de mettre à jour la même mémoire plus tard en re-POSTant avec la même clé.

Étape 3 : rechercher une mémoire spécifique

\n
GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY
Syntaxe FTS5 : plusieurs mots = recherche AND. Phrases entre guillemets :\n`\"docker swarm\"`. Recherche par préfixe : `docker*`. Booléen : `docker OR kubernetes`.

Outils ouverts (sans en-têtes d'auth)

\n

Si votre outil ne peut qu'ouvrir des URLs (pas d'en-têtes personnalisés), utilisez le\nparamètre ?key= :

\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=` est limité à 60 requêtes/minute. L'en-tête Bearer n'a pas de limite de\ndébit. Utilisez l'en-tête Bearer chaque fois que possible.

Workflow complet de session

\n
    \n
  1. Début de session : GET /memory/recall — charger toutes les mémoires
    2. \n
  2. Pendant le travail : GET /memory/search?q=... — trouver des faits spécifiques
    3. \n
  3. Sur nouvelle info : POST /memory — la stocker (avec catégorie, clé, tags, priorité)
    4. \n
  4. Périodiquement : GET /chat/poll — vérifier les messages humains
    5. \n
  5. Fin de session : Stocker tout apprentissage final via POST /memory
    6. \n
\n

Schémas courants

\n

Mettre à jour une mémoire existante

\n

POST /memory avec la même category et key — la mémoire existante est mise à\njour, pas dupliquée.

\n

Stocker un statut de projet

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

Enregistrer une erreur (pour ne pas la répéter)

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

Vérifier les messages humains

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

Renvoie les messages non lus de l'humain. Répondez avec :

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

Prochaines étapes

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