Mémoire pour Agents

Ce que contient ce pack

Ce pack rassemble les sept ressources de couche mémoire qui apparaissent dans chaque agent ayant besoin de se souvenir de choses entre sessions sans les recoller dans le prompt à chaque fois. Trois sont les librairies canoniques. Quatre sont des templates de patterns qui les enveloppent — patterns qu'Anthropic et OpenAI sortent dans leurs guides d'agents long-running.

Pourquoi c'est important

La config par défaut de Claude / GPT-4 / Gemini a zéro mémoire. Chaque conversation repart à zéro. La plupart des apps simulent la mémoire en entassant les tours précédents dans le system prompt — ça marche un temps, puis votre context window explose, votre facture triple et le modèle perd le fil. Les couches mémoire résolvent ça en stockant les faits hors du prompt et en n'injectant que les pertinents par tour.

Les trois librairies font des paris différents :

• Mem0 est la plus facile. Un appel mem0.add(messages, user_id=...) et la librairie extrait ce qui mérite d'être retenu. Mieux pour apps style chatbot avec identité claire.
• Zep est l'option production. Tourne en service, vous donne un graphe de connaissances temporel (mémoires avec timestamps et relations), supporte le multi-tenant. Mieux quand vous avez besoin d'audit trails ou de mémoire partagée dans une organisation.
• Cognee est le pari graph-native. Modélise la mémoire comme graphe de connaissances dès le jour un — utile si votre domaine est research, code, ou tout ce qui a des relations d'entités fortes.

Les quatre patterns ne sont pas des librairies — ce sont des templates de prompt et de petits adaptateurs qui marchent avec n'importe laquelle des trois. C'est la différence entre "j'ai installé Mem0" et "la mémoire fonctionne réellement dans mon app".

Installer en une commande

# Installe le pack entier
tokrepo install pack/agent-memory-layer

# Ou installez une librairie à la fois
tokrepo install mem0
tokrepo install zep
tokrepo install cognee

Le TokRepo CLI normalise le placement des fichiers : subagents Claude Code dans .claude/agents/, règles Cursor dans .cursor/rules/, AGENTS.md pour Codex CLI. Les installations de librairies sont pip/npm — TokRepo se contente de les câbler dans la config de votre outil IA pour que l'agent sache que la couche mémoire existe.

Pièges courants

• Ne stockez pas tout. Le coût mémoire scale avec ce que vous écrivez, pas ce que vous récupérez. Utilisez un extracteur de faits (pattern #6) pour filtrer — seuls les faits durables sur l'utilisateur/projet vont en mémoire long terme.
• Ne sautez pas le biais de récence. Le recall vectoriel pur tire des mémoires sémantiquement similaires mais rances. Le graphe temporel de Zep et la mise à jour in-place de Mem0 résolvent ça ; si vous le faites maison, pondérez par récence sinon vous récupérerez sans cesse du contexte de 6 mois.
• Ne partagez pas les user IDs entre tenants. Les trois librairies supportent les namespaces par utilisateur. Utilisez-les. La fuite mémoire entre utilisateurs est un incident bien pire que pas de mémoire du tout.
• Budgétez les tokens du recall. Même avec une couche mémoire, vous pouvez exploser votre context window avec top_k=50. Démarrez à top_k=5 et montez seulement si le recall manque.
• Réconciliez les conflits. Si l'utilisateur dit "je suis végétarien" en mars et "je suis végan" en mai, vous avez besoin d'une stratégie de mise à jour. Mem0 le gère seul ; Zep vous donne la surface de conflit ; Cognee vous laisse l'écrire.

Idées reçues courantes

"RAG et mémoire c'est pareil." Non. RAG récupère depuis un corpus statique (docs, codebase). La mémoire écrit de nouvelles entrées selon ce que l'utilisateur/agent a dit et les récupère plus tard. RAG est en lecture seule ; la mémoire est lecture-écriture. Les patterns du pack rag-pipelines diffèrent volontairement de ce pack.

"Je peux juste utiliser l'historique de conversation." Pour une session de 5 tours, oui. Pour une app où le même utilisateur revient la semaine prochaine, non — il faudrait nourrir tous les tours précédents dans le prompt à jamais. La mémoire extrait les faits et jette le chat.

"Mem0 vs Zep est un choix difficile." La plupart des équipes commencent par Mem0 car c'est 5 minutes de setup, puis passent à Zep quand elles ont besoin de multi-tenant ou d'audit. Les deux sont assez similaires pour que la migration soit un week-end, pas un trimestre.