# Bonnes pratiques mémoire
SUMMARY: Comment structurer les mémoires pour un rappel efficace — catégories, clés, tags, priorités.

Bonnes pratiques mémoire
La façon dont vous structurez les mémoires détermine leur utilité. Ce guide couvre
les schémas pour catégoriser, tagger et prioriser les mémoires afin que le LLM puisse
rappeler la bonne information au bon moment.
Catégories : choisissez la plus spécifique
| Catégorie | Utiliser pour | Exemple |
|----------|---------|---------|
|  | Nom d'utilisateur, rôle, infos de contact |  |
|  | Goûts, aversions, style de travail |  |
|  | Faits vérifiables |  |
|  | Statut de projet, décisions |  |
|  | Compétences de l'utilisateur |  |
|  | Erreurs passées à éviter |  |
|  | Contexte pertinent à la session |  |
|  | Notes diverses |  |
> [!TIP]
> En cas de doute, utilisez  pour les infos vérifiables et  pour tout le
> reste. Ne sur-catégorisez pas — mieux vaut avoir un  clair qu'un 
> confus.
Clés : identifiants significatifs
Le champ  est l'identifiant de la mémoire. Utilisez des clés significatives et
stables :
Bonnes clés :
- 
- 
- 
- 
Mauvaises clés :
-  (non significative)
-  (non descriptive)
-  (la date n'aide pas le rappel)
Conventions de nommage des clés
-  (minuscules avec tirets bas)
- Préfixez avec la catégorie : , , 
- Utilisez des noms descriptifs, pas des verbes
- Gardez en dessous de 50 caractères
Tags : pour la recherche et le filtrage
Les tags permettent le filtrage et la recherche rapides. Ajoutez 2-5 tags par mémoire :
[CODE BLOCK]
Schémas de tags
- Noms de projet : , , 
- Sujets : , , , 
- Statut : , , 
- Indicateurs de priorité : , 
> [!NOTE]
> Les tags sont insensibles à la casse. Utilisez des minuscules pour la cohérence.
Priorités : soyez réaliste
| Priorité | Utiliser pour | % des mémoires |
|----------|---------|---------------|
|  | Identité utilisateur, infos légales, décisions irréversibles | 5 % |
|  | Projets actifs, préférences importantes | 20 % |
|  | La plupart des faits, notes, contexte | 65 % |
|  | Éphémère, utile à savoir | 10 % |
> [!WARNING]
> Ne marquez pas tout . Si tout est critique, rien ne l'est. Réservez
>  pour ce qui causerait un réel préjudice si c'était oublié.
Quand stocker ou non
Toujours stocker
- Identité utilisateur (nom, email, rôle)
- Préférences longue durée
- Décisions de projet et justification
- Erreurs passées et leçons apprises
- Engagements pris envers l'utilisateur
Ne pas stocker
- État transitoire (utilisez plutôt des variables)
- Historique de conversation verbatim (le système chat gère cela)
- Données sensibles (mots de passe, clés API)
- Faits facilement dérivables (date actuelle, contenu de fichiers)
- Contexte éphémère (utilisez la catégorie  avec priorité basse)
Mettre à jour les mémoires
POST  avec la même  +  met à jour la mémoire existante :
[CODE BLOCK]
> [!TIP]
> Utilisez des clés stables pour pouvoir mettre à jour sans créer de doublons. Le LLM
> doit re-POSTer la même clé quand les infos changent, pas créer de nouvelles mémoires.
Cycle de vie d'une mémoire
[CODE BLOCK]
- Create : POST /memory avec contexte complet
- Active : Rappeler fréquemment, mettre à jour au besoin
- Stale : Toujours pertinent mais pas activement utilisé (priorité plus basse ?)
- Archive : Définir la priorité sur , conserver pour référence historique
- Delete : DELETE /memory/:id quand plus pertinent
Nettoyage périodique
[CODE BLOCK]
Schéma : héritage de mémoire
Pour un contexte hiérarchique (projet → sous-projet → tâche) :
[CODE BLOCK]
Le LLM peut alors chercher  pour trouver toutes les mémoires liées.
Schéma : journal de décisions
Stockez les décisions avec leur justification pour que le LLM ne les re-questionne
pas :
[CODE BLOCK]
Schéma : évitement des erreurs
Stockez les erreurs avec des instructions d'évitement spécifiques :
[CODE BLOCK]
Anti-schémas à éviter
> [!WARNING]
> - Stocker les journaux de conversation — le système chat gère cela
> - Stocker des fichiers entiers — utilisez le script store ou le stockage externe
> - Stocker l'état éphémère — utilisez des variables
> - Stocker des secrets — utilisez des variables d'environnement
> - Dupliquer les mémoires — utilisez des clés stables
> - Sur-tagger — 2-5 tags par mémoire est idéal
> - Tout est critique — soyez réaliste avec les priorités
Prochaines étapes
- API Memory
- Agent LLM persistant
- Stratégie de tagging mémoire