iris-development

# Iris: 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](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`](references/setup-cloud-service.md) - Create a Memory service on Redis Cloud - [`setup-auth-token`](references/setup-auth-token.md) - Authenticate the SDK with a store API key ### 2. Session Memory / Events (HIGH) - [`session-when-to-use`](references/session-when-to-use.md) - Choose session events vs direct long-term memory - [`session-add-event`](references/session-add-event.md) - Append a session event correctly - [`session-retrieval`](references/session-retrieval.md) - Retrieve session memory and individual events ### 3. Long-Term Memory (HIGH) - [`ltm-bulk-create`](references/ltm-bulk-create.md) - Create long-term memories in bulk with idempotent IDs - [`ltm-search`](references/ltm-search.md) - Search long-term memory semantically with filters - [`ltm-organize`](references/ltm-organize.md) - Organize records with namespace, ownerId, topics, and memoryType ### 4. Memory Promotion (MEDIUM) - [`promotion-overview`](references/promotion-overview.md) - 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