{"title":"Stratégie de tagging mémoire","slug":"memory-tagging-strategy","category":"llm-cookbook","summary":"Comment tagger les mémoires pour une recherche et un filtrage efficaces — le système de tagging qui passe à l'échelle.","audience":["llm"],"tags":["cookbook","tagging","memory","strategy"],"difficulty":"intermediate","updated":"2026-06-27","word_count":432,"read_minutes":2,"lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Stratégie de tagging mémoire\n\nLes tags sont le secret d'une récupération de mémoire qui passe à l'échelle. Ce guide\nmontre comment tagger les mémoires pour que les bonnes reviennent au bon moment.\n\n## Pourquoi les tags comptent\n\nSans tags, vous avez une recherche en texte intégral plate. Avec les tags, vous avez\nune navigation structurée :\n\n```bash\n# Sans tags : tout chercher\nGET /memory/search?q=docker\n\n# Avec tags : filtrer par projet + technologie\nGET /memory/search?q=deployment&tag=synapse&tag=docker\n```\n\nLes tags permettent :\n\n- **Filtrage rapide** — `GET /memory/by-tag?tag=production`\n- **Recherche scopée** — `?q=auth&tag=project-x`\n- **Regroupement** — trouver toutes les mémoires « mistake » d'un projet\n- **Référencement croisé** — les mémoires partageant des tags sont liées\n\n## Schéma de tagging\n\n### Tags de projet\n\nUtilisez les noms de projet comme tags :\n\n```\nsynapse, synapse-mcp, synapse-chat, synapse-sdk\n```\n\n### Tags de technologie\n\nUtilisez les noms de technologie :\n\n```\ndocker, kubernetes, postgres, fastify, react, typescript\n```\n\n### Tags de sujet\n\nUtilisez les catégories de sujet :\n\n```\ndeployment, ci-cd, auth, database, frontend, backend, security\n```\n\n### Tags de statut\n\nUtilisez les indicateurs de statut :\n\n```\nactive, completed, blocked, deprecated\n```\n\n### Tags de type\n\nUtilisez les indicateurs de type :\n\n```\ndecision, mistake, pattern, reference, todo\n```\n\n## Règles de tagging\n\n### Règle 1 : 2-5 tags par mémoire\n\nTrop peu de tags = mauvaise découvrabilité. Trop = du bruit.\n\n```json\n// Bien : 3 tags pertinents\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\"] }\n\n// Mal : 1 tag (trop étroit)\n{ \"tags\": [\"synapse\"] }\n\n// Mal : 10 tags (bruit)\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\", \"vps1\", \"2026\", \"june\", \"ssh\", \"git\", \"main\", \"production\"] }\n```\n\n### Règle 2 : minuscules, avec tirets\n\n```\n✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey\n```\n\n### Règle 3 : utiliser un vocabulaire cohérent\n\nÉtablissez un vocabulaire de tagging et tenez-vous-y :\n\n```\n# Vocabulaire de projet\nsynapse, synapse-mcp, synapse-chat\n\n# PAS : synapse_project, synapseProject, SYNAPSE\n```\n\n### Règle 4 : tagger avec intention de recherche\n\nDemandez : « Comment vais-je rechercher cette mémoire ? »\n\n```json\n// Stockage d'une décision de déploiement\n{\n \"content\": \"Decided to use Docker Swarm for Synapse deployment\",\n \"tags\": [\"synapse\", \"deployment\", \"docker\", \"swarm\", \"decision\"]\n}\n\n// Vous chercherez probablement : ?q=docker+swarm ou ?tag=deployment\n```\n\n## Schémas\n\n### Schéma 1 : projet + sujet\n\n```json\n{ \"tags\": [\"synapse\", \"deployment\"] }\n{ \"tags\": [\"synapse\", \"auth\"] }\n{ \"tags\": [\"synapse-mcp\", \"tools\"] }\n```\n\nRecherche : `?tag=synapse` (toutes les mémoires du projet Synapse)\nRecherche : `?tag=synapse&q=deployment` (mémoires de déploiement dans Synapse)\n\n### Schéma 2 : type + domaine\n\n```json\n{ \"tags\": [\"mistake\", \"deployment\"] }\n{ \"tags\": [\"decision\", \"database\"] }\n{ \"tags\": [\"pattern\", \"auth\"] }\n```\n\nRecherche : `?tag=mistake` (toutes les erreurs)\nRecherche : `?tag=mistake&q=deployment` (erreurs de déploiement)\n\n### Schéma 3 : hiérarchique\n\nPour les sous-projets au sein d'un projet :\n\n```json\n{ \"tags\": [\"synapse\", \"synapse-docs\", \"markdown\"] }\n{ \"tags\": [\"synapse\", \"synapse-mcp\", \"mcp\"] }\n{ \"tags\": [\"synapse\", \"synapse-admin\", \"ui\"] }\n```\n\nRecherche : `?tag=synapse` (tout Synapse)\nRecherche : `?tag=synapse-docs` (juste le sous-projet docs)\n\n### Schéma 4 : suivi de statut\n\n```json\n// Projet actif\n{ \"tags\": [\"synapse\", \"active\"], \"priority\": \"high\" }\n\n// Projet terminé\n{ \"tags\": [\"synapse-v1\", \"completed\"], \"priority\": \"low\" }\n\n// Bloqué\n{ \"tags\": [\"synapse-v2\", \"blocked\"], \"priority\": \"high\" }\n```\n\n## Cas d'usage courants\n\n### Trouver toutes les décisions sur un projet\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=decision&tag=synapse\"\n```\n\n### Trouver toutes les erreurs dans un domaine\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=mistake&tag=deployment\"\n```\n\n### Trouver le travail actif\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/by-tag?tag=active\"\n```\n\n### Trouver des mémoires sur une technologie\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=postgres+performance&tag=database\"\n```\n\n## Maintenance des tags\n\n### Revue périodique\n\n```python\n# Trouver les tags rarement utilisés (candidats au nettoyage)\ntags = requests.get(f\"{URL}/memory/tags\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\nfor tag, count in tags.items():\n if count < 2:\n print(f\"Rare tag: {tag} ({count} memories)\")\n```\n\n### Fusionner les tags\n\nSi vous avez des tags incohérents (`docker` et `Docker`), fusionnez-les :\n\n```python\n# Trouver toutes les mémoires avec le tag \"Docker\"\nmems = requests.get(f\"{URL}/memory/by-tag?tag=Docker\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\n# Mettre à jour chacune pour utiliser \"docker\" à la place\nfor mem in mems[\"results\"]:\n tags = [t.lower() for t in mem[\"tags\"]]\n update_memory(mem[\"id\"], tags=list(set(tags)))\n```\n\n## Bonnes pratiques\n\n> [!TIP]\n> - **Établir le vocabulaire tôt** — des tags cohérents dès le jour 1\n> - **Tagger avec intention de recherche** — comment trouverez-vous cela plus tard ?\n> - **2-5 tags est le sweet spot** — trop peu ou trop est mauvais\n> - **Minuscules + tirets** — `ci-cd` pas `CI/CD`\n> - **Revue périodique** — fusionner les doublons, supprimer les inutilisés\n\n## Prochaines étapes\n\n- [Bonnes pratiques mémoire](/docs/guides/memory-best-practices)\n- [Recherche FTS5](/docs/concepts/fts5-search)\n- [Workflow piloté par les tâches](/docs/llm-cookbook/task-driven-workflow)\n","content_html":"

Stratégie de tagging mémoire

\n

Les tags sont le secret d'une récupération de mémoire qui passe à l'échelle. Ce guide\nmontre comment tagger les mémoires pour que les bonnes reviennent au bon moment.

\n

Pourquoi les tags comptent

\n

Sans tags, vous avez une recherche en texte intégral plate. Avec les tags, vous avez\nune navigation structurée :

\n
# Sans tags : tout chercher\nGET /memory/search?q=docker\n\n# Avec tags : filtrer par projet + technologie\nGET /memory/search?q=deployment&tag=synapse&tag=docker

Les tags permettent :

\n\n

Schéma de tagging

\n

Tags de projet

\n

Utilisez les noms de projet comme tags :

\n
synapse, synapse-mcp, synapse-chat, synapse-sdk

Tags de technologie

\n

Utilisez les noms de technologie :

\n
docker, kubernetes, postgres, fastify, react, typescript

Tags de sujet

\n

Utilisez les catégories de sujet :

\n
deployment, ci-cd, auth, database, frontend, backend, security

Tags de statut

\n

Utilisez les indicateurs de statut :

\n
active, completed, blocked, deprecated

Tags de type

\n

Utilisez les indicateurs de type :

\n
decision, mistake, pattern, reference, todo

Règles de tagging

\n

Règle 1 : 2-5 tags par mémoire

\n

Trop peu de tags = mauvaise découvrabilité. Trop = du bruit.

\n
// Bien : 3 tags pertinents\n{ "tags": ["synapse", "deployment", "docker"] }\n\n// Mal : 1 tag (trop étroit)\n{ "tags": ["synapse"] }\n\n// Mal : 10 tags (bruit)\n{ "tags": ["synapse", "deployment", "docker", "vps1", "2026", "june", "ssh", "git", "main", "production"] }

Règle 2 : minuscules, avec tirets

\n
✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey

Règle 3 : utiliser un vocabulaire cohérent

\n

Établissez un vocabulaire de tagging et tenez-vous-y :

\n
# Vocabulaire de projet\nsynapse, synapse-mcp, synapse-chat\n\n# PAS : synapse_project, synapseProject, SYNAPSE

Règle 4 : tagger avec intention de recherche

\n

Demandez : « Comment vais-je rechercher cette mémoire ? »

\n
// Stockage d'une décision de déploiement\n{\n  "content": "Decided to use Docker Swarm for Synapse deployment",\n  "tags": ["synapse", "deployment", "docker", "swarm", "decision"]\n}\n\n// Vous chercherez probablement : ?q=docker+swarm ou ?tag=deployment

Schémas

\n

Schéma 1 : projet + sujet

\n
{ "tags": ["synapse", "deployment"] }\n{ "tags": ["synapse", "auth"] }\n{ "tags": ["synapse-mcp", "tools"] }

Recherche : ?tag=synapse (toutes les mémoires du projet Synapse)\nRecherche : ?tag=synapse&q=deployment (mémoires de déploiement dans Synapse)

\n

Schéma 2 : type + domaine

\n
{ "tags": ["mistake", "deployment"] }\n{ "tags": ["decision", "database"] }\n{ "tags": ["pattern", "auth"] }

Recherche : ?tag=mistake (toutes les erreurs)\nRecherche : ?tag=mistake&q=deployment (erreurs de déploiement)

\n

Schéma 3 : hiérarchique

\n

Pour les sous-projets au sein d'un projet :

\n
{ "tags": ["synapse", "synapse-docs", "markdown"] }\n{ "tags": ["synapse", "synapse-mcp", "mcp"] }\n{ "tags": ["synapse", "synapse-admin", "ui"] }

Recherche : ?tag=synapse (tout Synapse)\nRecherche : ?tag=synapse-docs (juste le sous-projet docs)

\n

Schéma 4 : suivi de statut

\n
// Projet actif\n{ "tags": ["synapse", "active"], "priority": "high" }\n\n// Projet terminé\n{ "tags": ["synapse-v1", "completed"], "priority": "low" }\n\n// Bloqué\n{ "tags": ["synapse-v2", "blocked"], "priority": "high" }

Cas d'usage courants

\n

Trouver toutes les décisions sur un projet

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=decision&tag=synapse"

Trouver toutes les erreurs dans un domaine

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=mistake&tag=deployment"

Trouver le travail actif

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/by-tag?tag=active"

Trouver des mémoires sur une technologie

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=postgres+performance&tag=database"

Maintenance des tags

\n

Revue périodique

\n
# Trouver les tags rarement utilisés (candidats au nettoyage)\ntags = requests.get(f"{URL}/memory/tags",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\nfor tag, count in tags.items():\n    if count < 2:\n        print(f"Rare tag: {tag} ({count} memories)")

Fusionner les tags

\n

Si vous avez des tags incohérents (docker et Docker), fusionnez-les :

\n
# Trouver toutes les mémoires avec le tag "Docker"\nmems = requests.get(f"{URL}/memory/by-tag?tag=Docker",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\n# Mettre à jour chacune pour utiliser "docker" à la place\nfor mem in mems["results"]:\n    tags = [t.lower() for t in mem["tags"]]\n    update_memory(mem["id"], tags=list(set(tags)))

Bonnes pratiques

\n

Prochaines étapes

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