Iris : Redis Agent Memory
Iris est la marque parapluie pour les produits d'IA de Redis. Cette skill couvre actuellement un produit de cette famille : Redis Agent Memory (RAM) — la couche de mémoire persistante pour les agents IA, livrée en tant que service géré sur Redis Cloud. Les produits Iris supplémentaires seront ajoutés en tant que sections distinctes à leur lancement.
Redis Agent Memory expose une API data-plane REST/JSON avec deux niveaux de mémoire :
- Session memory — historique de conversation append-only par session (mémoire de travail).
- Long-term memory — enregistrements recherchables sémantiquement extraits des sessions (ou créés directement).
Un worker promotion en arrière-plan — géré par Redis Cloud — extrait les faits durables des événements de session et les écrit dans la mémoire à long terme.
SDKs officiels
Tous les exemples de code utilisent les SDKs officiels :
| Langage | Package | Classe | Installation |
|---|---|---|---|
| Python | redis-agent-memory |
AgentMemory |
pip install redis-agent-memory |
| TypeScript | @redis-iris/agent-memory |
AgentMemory |
npm add @redis-iris/agent-memory |
Les deux SDKs lisent le token bearer depuis AGENT_MEMORY_API_KEY et l'ID de store par défaut depuis AGENT_MEMORY_STORE_ID. L'URL data-plane de production est https://gcp-us-east4.memory.redis.io ; l'URL exacte pour votre service est également affichée dans la console Cloud après le provisionnement.
Quand appliquer
Référencez ces lignes directrices quand :
- Créer un service de mémoire sur Redis Cloud (https://cloud.redis.io/#/agent-memory)
- Connecter un agent pour appeler
AgentMemory.add_session_event(...)/addSessionEvent(...) - Rechercher la mémoire à long terme avec
search_long_term_memory(...)/searchLongTermMemory(...) - Choisir entre les événements de session et les écritures directes en mémoire à long terme
Catégories de règles par priorité
| Priorité | Catégorie | Impact | Préfixe |
|---|---|---|---|
| 1 | Setup & Cloud Service | HIGH | setup- |
| 2 | Session Memory / Events | HIGH | session- |
| 3 | Long-Term Memory | HIGH | ltm- |
| 4 | Memory Promotion | MEDIUM | promotion- |
Référence rapide
1. Setup & Cloud Service (HIGH)
setup-cloud-service- Créer un service Memory sur Redis Cloudsetup-auth-token- Authentifier le SDK avec une clé API de store
2. Session Memory / Events (HIGH)
session-when-to-use- Choisir entre les événements de session et la mémoire à long terme directesession-add-event- Ajouter correctement un événement de sessionsession-retrieval- Récupérer la mémoire de session et les événements individuels
3. Long-Term Memory (HIGH)
ltm-bulk-create- Créer des mémoires à long terme en masse avec des IDs idempotentsltm-search- Rechercher la mémoire à long terme sémantiquement avec des filtresltm-organize- Organiser les enregistrements avec namespace, ownerId, topics et memoryType
4. Memory Promotion (MEDIUM)
promotion-overview- Comment fonctionne la promotion en arrière-plan
Comment l'utiliser
Lisez les fichiers de règles individuels pour des explications détaillées et des exemples de code :
rules/setup-cloud-service.md
rules/session-add-event.md
rules/promotion-overview.mdChaque fichier de règle contient :
- Une brève explication de son importance
- Un ou plusieurs exemples corrects avec du code SDK Python et TypeScript
- Soit un exemple « Incorrect », soit des conseils « Quand utiliser / Quand ce n'est pas nécessaire »
- Un contexte supplémentaire et des références
Document compilé complet
Pour le guide complet avec toutes les règles développées : AGENTS.md