사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/redis/agent-skills --skill iris-development시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
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)
- 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 Cloud
- `setup-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 memory
- `session-add-event` - Append a session event correctly
- `session-retrieval` - Retrieve session memory and individual events
3. Long-Term Memory (HIGH)
- `ltm-bulk-create` - Create long-term memories in bulk with idempotent IDs
- `ltm-search` - Search long-term memory semantically with filters
- `ltm-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.mdEach 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
