iris-development
Iris est le parapluie de Redis pour les produits axés sur l'IA. Utilisez cette compétence lors de l'intégration avec le plan de données Iris Redis Agent Memory (RAM) sur Redis Cloud — enregistrement…
npx skills add https://github.com/redis/agent-skills --skill iris-developmentIris: Redis Agent Memory
Iris is the umbrella brand for Redis's AI-focused products. This skill currently covers one product in that family: Redis Agent Memory (RAM) — the persistent memory layer for AI agents, delivered as a managed service on Redis Cloud. Additional Iris products will be added as separate sections when they ship.
Redis Agent Memory exposes a REST/JSON data-plane API with two memory tiers:
- Session memory — append-only conversation history per session (working memory).
- Long-term memory — semantically searchable records extracted from sessions (or created directly).
A background promotion worker — managed by Redis Cloud — extracts durable facts from session events and writes them into long-term memory.
Official SDKs
All code samples use the official SDKs:
| Language | Package | Class | Install |
|---|---|---|---|
| Python | redis-agent-memory | AgentMemory | pip install redis-agent-memory |
| TypeScript | @redis-iris/agent-memory | AgentMemory | npm add @redis-iris/agent-memory |
Both SDKs read the bearer token from AGENT_MEMORY_API_KEY and the default store ID from AGENT_MEMORY_STORE_ID. The production data-plane URL is https://gcp-us-east4.memory.redis.io; the exact URL for your service is also shown in the Cloud console after provisioning.
When to Apply
Reference these guidelines when:
- Creating a memory service on Redis Cloud (https://cloud.redis.io/#/agent-memory)
- Wiring an agent to call
AgentMemory.add_session_event(...)/addSessionEvent(...) - Searching long-term memory with
search_long_term_memory(...)/searchLongTermMemory(...) - Choosing between session events and direct long-term memory writes
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Setup & Cloud Service | HIGH | setup- |
| 2 | Session Memory / Events | HIGH | session- |
| 3 | Long-Term Memory | HIGH | ltm- |
| 4 | Memory Promotion | MEDIUM | promotion- |
Quick Reference
1. Setup & Cloud Service (HIGH)
setup-cloud-service- Create a Memory service on Redis Cloudsetup-auth-token- Authenticate the SDK with a store API key
2. Session Memory / Events (HIGH)
session-when-to-use- Choose session events vs direct long-term memorysession-add-event- Append a session event correctlysession-retrieval- Retrieve session memory and individual events
3. Long-Term Memory (HIGH)
ltm-bulk-create- Create long-term memories in bulk with idempotent IDsltm-search- Search long-term memory semantically with filtersltm-organize- Organize records with namespace, ownerId, topics, and memoryType
4. Memory Promotion (MEDIUM)
promotion-overview- How background promotion works
How to Use
Read individual rule files under references/ for detailed explanations and code examples:
references/setup-cloud-service.md
references/session-add-event.md
references/promotion-overview.md
Each rule file contains:
- Brief explanation of why it matters
- Correct example(s) with Python and TypeScript SDK code
- Either an "Incorrect" example or "When to use / When NOT needed" guidance
- Additional context and references