iris-development
Iris is Redis's umbrella for AI-focused products. Use this skill when integrating with the Iris Redis Agent Memory (RAM) data plane on Redis Cloud — recording session events for an AI agent, creating or searching long-term memories, configuring a memory store, or tuning background memory promotion.
By redis · 1,290 installs
npx skills add redis/agent-skills --skill iris-development
Source repository · Upstream listing
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:
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