{"title":"Le modèle de mémoire","slug":"memory-model","category":"concepts","summary":"Comment les mémoires sont structurées — catégories, clés, tags, priorités, sources, vérification.","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":803,"read_minutes":4,"lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Le modèle de mémoire\n\nLe modèle de mémoire de Synapse est conçu pour les agents LLM — suffisamment structuré\npour un rappel fiable, suffisamment flexible pour tout domaine.\n\n## Anatomie d'une mémoire\n\n```json\n{\n \"id\": \"mem_abc123\",\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed on vps1. CI green.\",\n \"tags\": [\"synapse\", \"deployment\", \"v1.5.0\"],\n \"priority\": \"high\",\n \"source\": \"agent\",\n \"verified\": false,\n \"confidence\": 0.85,\n \"expires_at\": null,\n \"mind_id\": \"m_xyz789\",\n \"created_at\": \"2026-06-27T...\",\n \"updated_at\": \"2026-06-27T...\"\n}\n```\n\n## Champs\n\n| Champ | Type | Requis | Description |\n|-------|------|----------|-------------|\n| `id` | string | auto | Identifiant unique (mem_xxx) |\n| `category` | enum | ✅ | Une des 8 catégories |\n| `key` | string | ✅ | Identifiant stable (utilisé pour les mises à jour) |\n| `content` | string | ✅ | Le contenu de la mémoire (n'importe quel texte) |\n| `tags` | string[] | – | Pour la recherche et le filtrage |\n| `priority` | enum | – | low, normal, high, critical (par défaut : normal) |\n| `source` | enum | auto | user, agent (qui l'a stockée) |\n| `verified` | bool | auto | Un humain a-t-il vérifié ceci ? |\n| `confidence` | float | – | 0.0 à 1.0 (par défaut : 1.0 pour user, 0.7 pour agent) |\n| `expires_at` | timestamp | – | Quand oublier cette mémoire |\n| `mind_id` | string | auto | Quel mind possède ceci |\n| `created_at` | timestamp | auto | Premier stockage |\n| `updated_at` | timestamp | auto | Dernière modification |\n\n## Catégories\n\nHuit catégories couvrent les cas d'usage courants des agents LLM :\n\n| Catégorie | Rôle | Exemple de contenu |\n|----------|---------|-----------------|\n| `identity` | Qui est l'utilisateur | \"User is Michael Schäfer, software engineer in Berlin\" |\n| `preference` | Préférences utilisateur | \"Prefers concise technical responses\" |\n| `fact` | Faits vérifiables | \"Office is in Berlin, timezone Europe/Berlin\" |\n| `project` | Statut de projet | \"Synapse v1.5.0 deployed, working on v1.6.0 docs\" |\n| `skill` | Compétences de l'utilisateur | \"Advanced Python, 10+ years\" |\n| `mistake` | Erreurs passées | \"Forgot to bump npm version — CI failed\" |\n| `context` | Contexte de session | \"Currently reviewing PR #42\" |\n| `note` | Notes diverses | \"Try Redis for caching next sprint\" |\n\n## Clés : identifiants stables\n\nLe champ `key` est critique — c'est ainsi que vous mettez à jour les mémoires sans\ncréer de doublons.\n\n```python\n# Premier stockage\nstore(\"project\", \"project_synapse_status\", \"v1.4.0 deployed\", priority=\"high\")\n\n# Mise à jour avec la même clé (écrase, ne duplique pas)\nstore(\"project\", \"project_synapse_status\", \"v1.5.0 deployed\", priority=\"high\")\n```\n\n**Règles de clé :**\n\n- Doit être unique dans (catégorie, mind)\n- Utilisez `snake_case`\n- Préfixez avec la catégorie pour plus de clarté : `preference_communication`, `mistake_npm_version`\n- Gardez-la stable — ne changez pas les clés après création\n\n## Tags : pour la recherche\n\nLes tags permettent le filtrage et la recherche rapides :\n\n```bash\n# Trouver toutes les mémoires avec le tag \"docker\"\nGET /memory/by-tag?tag=docker\n\n# Recherche FTS5 dans un sous-ensemble tagué\nGET /memory/search?q=swarm&tag=docker\n```\n\n**Bonnes pratiques de tag :**\n\n- 2-5 tags par mémoire (ne pas sur-tagger)\n- Minuscules pour la cohérence\n- Utilisez des noms de projet, sujets, technologies\n- Les tags sont insensibles à la casse\n\n## Niveaux de priorité\n\n| Priorité | Quand l'utiliser | Comportement de rappel |\n|----------|-------------|-----------------|\n| `critical` | Identité, juridique, irréversible | Toujours en haut du rappel |\n| `high` | Projets actifs, préférences clés | Proéminent dans le rappel |\n| `normal` | La plupart des mémoires (par défaut) | Ordre de rappel standard |\n| `low` | Éphémère, utile à savoir | Peut être résumé |\n\n`/memory/recall` trie par priorité (critical d'abord), puis par récence.\n\n## Source : User vs Agent\n\nLes mémoires sont marquées avec `source` :\n\n- `user` — stockée par un humain (via JWT ou interface humaine)\n- `agent` — stockée par un agent LLM (via Mind Key)\n\nCela affecte :\n\n- **Vérification** : les mémoires `user` sont auto-vérifiées, les mémoires `agent` ne le sont pas\n- **Confiance** : `user` par défaut à 1.0, `agent` à 0.7\n- **Rappel** : `/memory/recall` marque les mémoires non vérifiées avec « (unverified) »\n\n> [!NOTE]\n> Traitez les mémoires `agent` avec un scepticisme approprié. Elles peuvent être\n> déduites ou supposées plutôt que directement énoncées par l'utilisateur.\n\n## Vérification\n\nLe drapeau `verified` indique qu'un humain a confirmé la mémoire :\n\n- Mémoires `user` : auto-vérifiées (`true`)\n- Mémoires `agent` : non vérifiées par défaut (`false`)\n\nVérifiez les mémoires via :\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n -H \"Authorization: Bearer YOUR_JWT\"\n```\n\n> [!NOTE]\n> La vérification nécessite un JWT (auth humaine), pas une Mind Key (auth agent).\n> Cela garantit que seuls les humains peuvent marquer des mémoires comme vérifiées.\n\n## Confiance\n\nLe champ `confidence` (0.0 à 1.0) indique la fiabilité de la mémoire :\n\n- 1.0 — directement énoncée par l'utilisateur\n- 0.7 — déduite par l'agent\n- 0.5 — incertaine, nécessite vérification\n- 0.0 — explicitement doutée\n\nDéfinissez la confiance lors du stockage :\n\n```json\n{\n \"category\": \"preference\",\n \"key\": \"prefers_dark_mode\",\n \"content\": \"User seems to prefer dark mode (based on their IDE screenshots)\",\n \"confidence\": 0.5,\n \"source\": \"agent\"\n}\n```\n\n## Expiration\n\nDéfinissez `expires_at` pour les mémoires sensibles au temps :\n\n```json\n{\n \"category\": \"context\",\n \"key\": \"current_meeting_topic\",\n \"content\": \"Discussing Q3 roadmap\",\n \"expires_at\": \"2026-06-28T00:00:00Z\"\n}\n```\n\nLes mémoires expirées ne sont pas renvoyées par `/memory/recall` (mais existent\ntoujours en base). Utilisez `/memory/expiring?within=7d` pour voir les mémoires\nexpirant bientôt.\n\n## Cycle de vie d'une mémoire\n\n```\n ┌─────────────────┐\n │ Create │\n │ POST /memory │\n └────────┬────────┘\n │\n ▼\n ┌─────────────────┐\n │ Active │ ◀──── PUT /memory/:id (update)\n │ (in recall) │\n └────────┬────────┘\n │\n ┌────────────┼────────────┐\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ Expired │ │ Verified │ │ Deleted │\n │ (in DB) │ │ (flag) │ │ (gone) │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Comportement de rappel\n\n`GET /memory/recall` renvoie un résumé en texte brut optimisé pour le contexte LLM :\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified, 2 unverified)\n\n[001] identity (CRITICAL) [verified]\n user_name\n Michael Schäfer\n Tags: person, identity\n\n[002] preference (HIGH) [verified]\n communication_style\n Prefers concise technical responses\n Tags: communication\n\n[003] project (HIGH) [unverified]\n synapse_status\n v1.5.0 deployed, working on v1.6.0 docs\n Tags: synapse, deployment\n\n...\n```\n\n- Trié par priorité (critical → low), puis par récence\n- Mémoires non vérifiées marquées avec `[unverified]`\n- Tags inclus pour le contexte\n- Texte brut (pas d'analyse JSON nécessaire)\n\n## Prochaines étapes\n\n- [API Memory](/docs/api/memory)\n- [Bonnes pratiques mémoire](/docs/guides/memory-best-practices)\n- [Recherche FTS5](/docs/concepts/fts5-search)\n","content_html":"

Le modèle de mémoire

\n

Le modèle de mémoire de Synapse est conçu pour les agents LLM — suffisamment structuré\npour un rappel fiable, suffisamment flexible pour tout domaine.

\n

Anatomie d'une mémoire

\n
{\n  "id": "mem_abc123",\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed on vps1. CI green.",\n  "tags": ["synapse", "deployment", "v1.5.0"],\n  "priority": "high",\n  "source": "agent",\n  "verified": false,\n  "confidence": 0.85,\n  "expires_at": null,\n  "mind_id": "m_xyz789",\n  "created_at": "2026-06-27T...",\n  "updated_at": "2026-06-27T..."\n}

Champs

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ChampTypeRequisDescription
idstringautoIdentifiant unique (mem_xxx)
categoryenum✅Une des 8 catégories
keystring✅Identifiant stable (utilisé pour les mises à jour)
contentstring✅Le contenu de la mémoire (n'importe quel texte)
tagsstring[]–Pour la recherche et le filtrage
priorityenum–low, normal, high, critical (par défaut : normal)
sourceenumautouser, agent (qui l'a stockée)
verifiedboolautoUn humain a-t-il vérifié ceci ?
confidencefloat–0.0 à 1.0 (par défaut : 1.0 pour user, 0.7 pour agent)
expires_attimestamp–Quand oublier cette mémoire
mind_idstringautoQuel mind possède ceci
created_attimestampautoPremier stockage
updated_attimestampautoDernière modification
\n

Catégories

\n

Huit catégories couvrent les cas d'usage courants des agents LLM :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CatégorieRôleExemple de contenu
identityQui est l'utilisateur"User is Michael Schäfer, software engineer in Berlin"
preferencePréférences utilisateur"Prefers concise technical responses"
factFaits vérifiables"Office is in Berlin, timezone Europe/Berlin"
projectStatut de projet"Synapse v1.5.0 deployed, working on v1.6.0 docs"
skillCompétences de l'utilisateur"Advanced Python, 10+ years"
mistakeErreurs passées"Forgot to bump npm version — CI failed"
contextContexte de session"Currently reviewing PR #42"
noteNotes diverses"Try Redis for caching next sprint"
\n

Clés : identifiants stables

\n

Le champ key est critique — c'est ainsi que vous mettez à jour les mémoires sans\ncréer de doublons.

\n
# Premier stockage\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# Mise à jour avec la même clé (écrase, ne duplique pas)\nstore("project", "project_synapse_status", "v1.5.0 deployed", priority="high")

Règles de clé :

\n\n

Tags : pour la recherche

\n

Les tags permettent le filtrage et la recherche rapides :

\n
# Trouver toutes les mémoires avec le tag "docker"\nGET /memory/by-tag?tag=docker\n\n# Recherche FTS5 dans un sous-ensemble tagué\nGET /memory/search?q=swarm&tag=docker

Bonnes pratiques de tag :

\n\n

Niveaux de priorité

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
PrioritéQuand l'utiliserComportement de rappel
criticalIdentité, juridique, irréversibleToujours en haut du rappel
highProjets actifs, préférences clésProéminent dans le rappel
normalLa plupart des mémoires (par défaut)Ordre de rappel standard
lowÉphémère, utile à savoirPeut être résumé
\n

/memory/recall trie par priorité (critical d'abord), puis par récence.

\n

Source : User vs Agent

\n

Les mémoires sont marquées avec source :

\n\n

Cela affecte :

\n\n
Traitez les mémoires `agent` avec un scepticisme approprié. Elles peuvent être\ndéduites ou supposées plutôt que directement énoncées par l'utilisateur.

Vérification

\n

Le drapeau verified indique qu'un humain a confirmé la mémoire :

\n\n

Vérifiez les mémoires via :

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
La vérification nécessite un JWT (auth humaine), pas une Mind Key (auth agent).\nCela garantit que seuls les humains peuvent marquer des mémoires comme vérifiées.

Confiance

\n

Le champ confidence (0.0 à 1.0) indique la fiabilité de la mémoire :

\n\n

Définissez la confiance lors du stockage :

\n
{\n  "category": "preference",\n  "key": "prefers_dark_mode",\n  "content": "User seems to prefer dark mode (based on their IDE screenshots)",\n  "confidence": 0.5,\n  "source": "agent"\n}

Expiration

\n

Définissez expires_at pour les mémoires sensibles au temps :

\n
{\n  "category": "context",\n  "key": "current_meeting_topic",\n  "content": "Discussing Q3 roadmap",\n  "expires_at": "2026-06-28T00:00:00Z"\n}

Les mémoires expirées ne sont pas renvoyées par /memory/recall (mais existent\ntoujours en base). Utilisez /memory/expiring?within=7d pour voir les mémoires\nexpirant bientôt.

\n

Cycle de vie d'une mémoire

\n
                  ┌─────────────────┐\n                  │     Create      │\n                  │  POST /memory   │\n                  └────────┬────────┘\n                           │\n                           ▼\n                  ┌─────────────────┐\n                  │     Active      │ ◀──── PUT /memory/:id (update)\n                  │  (in recall)    │\n                  └────────┬────────┘\n                           │\n              ┌────────────┼────────────┐\n              │            │            │\n              ▼            ▼            ▼\n        ┌──────────┐ ┌──────────┐ ┌──────────┐\n        │ Expired  │ │ Verified │ │ Deleted  │\n        │ (in DB)  │ │ (flag)   │ │ (gone)   │\n        └──────────┘ └──────────┘ └──────────┘

Comportement de rappel

\n

GET /memory/recall renvoie un résumé en texte brut optimisé pour le contexte LLM :

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified, 2 unverified)\n\n[001] identity (CRITICAL) [verified]\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n[002] preference (HIGH) [verified]\n  communication_style\n  Prefers concise technical responses\n  Tags: communication\n\n[003] project (HIGH) [unverified]\n  synapse_status\n  v1.5.0 deployed, working on v1.6.0 docs\n  Tags: synapse, deployment\n\n...
\n

Prochaines étapes

\n\n","urls":{"html":"/docs/concepts/memory-model","text":"/docs/concepts/memory-model?format=text","json":"/docs/concepts/memory-model?format=json","llm":"/docs/concepts/memory-model?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}