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:

Both SDKs read the bearer token from AGENTMEMORYAPIKEY and the default store ID from AGENTMEMORYSTOREID. 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.addsessionevent(...) / addSessionEvent(...)
• Searching long-term memory with searchlongterm_memory(...) / searchLongTermMemory(...)
• Choosing between session events and direct long-term memory writes

Rule Categories by Priority

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