Iris : Redis Agent Memory

Iris est la marque parapluie pour les produits orientés 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, fournie en tant que service géré sur Redis Cloud. D'autres produits Iris seront ajoutés dans des sections séparées à 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 explorable 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 :

Les deux SDKs lisent le bearer token 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 provisioning.

Quand appliquer

Consultez ces lignes directrices quand :

• Créer un service mémoire sur Redis Cloud (https://cloud.redis.io/#/agent-memory)
• Câbler un agent pour appeler AgentMemory.add_session_event(...) / addSessionEvent(...)
• Rechercher dans 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é

Référence rapide

1. Setup & Cloud Service (HIGH)

• setup-cloud-service - Créer un service Memory sur Redis Cloud
• setup-auth-token - Authentifier le SDK avec une clé API de store

2. Session Memory / Events (HIGH)

• session-when-to-use - Choisir entre événements de session et mémoire long terme directe
• session-add-event - Ajouter un événement de session correctement
• session-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 idempotents
• ltm-search - Rechercher la mémoire long terme sémantiquement avec des filtres
• ltm-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 utiliser

Lisez les fichiers de règles individuels sous references/ pour des explications détaillées et des exemples de code :

references/setup-cloud-service.md
references/session-add-event.md
references/promotion-overview.md

Chaque fichier de règle contient :

• Une brève explication de son importance
• Un ou des exemples corrects avec du code SDK Python et TypeScript
• Soit un exemple « Incorrect », soit une guidance « Quand utiliser / Quand non nécessaire »
• Du contexte supplémentaire et des références