iris-development

Name: iris-development
Author: redis

713installs22forks

How to install iris-development?

redis/agent-skills/iris-development

$npx -y skills add redis/agent-skills --skill iris-development

Installs into the current project.

Summary

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 backgroun

Files · 1

View on GitHub

SKILL.md

1	# Iris: Redis Agent Memory
2
3	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.
4
5	Redis Agent Memory exposes a REST/JSON data-plane API with two memory tiers:
6
7	- Session memory — append-only conversation history per session (working memory).
8	- Long-term memory — semantically searchable records extracted from sessions (or created directly).
9
10	A background promotion worker — managed by Redis Cloud — extracts durable facts from session events and writes them into long-term memory.
11
12	## Official SDKs
13
14	All code samples use the official SDKs:
15
16
17	\| Language \| Package \| Class \| Install \|
18	\| ---------- \| -------------------------- \| ------------- \| ---------------------------------- \|
19	\| Python \| `redis-agent-memory` \| `AgentMemory` \| `pip install redis-agent-memory` \|
20	\| TypeScript \| `@redis-iris/agent-memory` \| `AgentMemory` \| `npm add @redis-iris/agent-memory` \|
21
22
23	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.
24
25	## When to Apply
26
27	Reference these guidelines when:
28
29	- Creating a memory service on Redis Cloud ([https://cloud.redis.io/#/agent-memory](https://cloud.redis.io/#/agent-memory))
30	- Wiring an agent to call `AgentMemory.add_session_event(...)` / `addSessionEvent(...)`
31	- Searching long-term memory with `search_long_term_memory(...)` / `searchLongTermMemory(...)`
32	- Choosing between session events and direct long-term memory writes
33
34	## Rule Categories by Priority
35
36
37	\| Priority \| Category \| Impact \| Prefix \|
38	\| -------- \| ----------------------- \| ------ \| ------------ \|
39	\| 1 \| Setup & Cloud Service \| HIGH \| `setup-` \|
40	\| 2 \| Session Memory / Events \| HIGH \| `session-` \|
41	\| 3 \| Long-Term Memory \| HIGH \| `ltm-` \|
42	\| 4 \| Memory Promotion \| MEDIUM \| `promotion-` \|
43
44
45	## Quick Reference
46
47	### 1. Setup & Cloud Service (HIGH)
48
49	- [`setup-cloud-service`](references/setup-cloud-service.md) - Create a Memory service on Redis Cloud
50	- [`setup-auth-token`](references/setup-auth-token.md) - Authenticate the SDK with a store API key
51
52	### 2. Session Memory / Events (HIGH)
53
54	- [`session-when-to-use`](references/session-when-to-use.md) - Choose session events vs direct long-term memory
55	- [`session-add-event`](references/session-add-event.md) - Append a session event correctly
56	- [`session-retrieval`](references/session-retrieval.md) - Retrieve session memory and individual events
57
58	### 3. Long-Term Memory (HIGH)
59
60	- [`ltm-bulk-create`](references/ltm-bulk-create.md) - Create long-term memories in bulk with idempotent IDs
61	- [`ltm-search`](references/ltm-search.md) - Search long-term memory semantically with filters
62	- [`ltm-organize`](references/ltm-organize.md) - Organize records with namespace, ownerId, topics, and memoryType
63
64	### 4. Memory Promotion (MEDIUM)
65
66	- [`promotion-overview`](references/promotion-overview.md) - How background promotion works
67
68	## How to Use
69
70	Read individual rule files under `references/` for detailed explanations and code examples:
71
72	```
73	references/setup-cloud-service.md
74	references/session-add-event.md
75	references/promotion-overview.md
76	```
77
78	Each rule file contains:
79
80	- Brief explanation of why it matters
81	- Correct example(s) with Python and TypeScript SDK code
82	- Either an "Incorrect" example or "When to use / When NOT needed" guidance
83	- Additional context and references

People who liked this also viewed

6 picks

Type

iris-development

713installs22forks

View on GitHub

How to install iris-development?

redis/agent-skills/iris-development

$npx -y skills add redis/agent-skills --skill iris-development

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Iris: Redis Agent Memory
2
3	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.
4
5	Redis Agent Memory exposes a REST/JSON data-plane API with two memory tiers:
6
7	- Session memory — append-only conversation history per session (working memory).
8	- Long-term memory — semantically searchable records extracted from sessions (or created directly).
9
10	A background promotion worker — managed by Redis Cloud — extracts durable facts from session events and writes them into long-term memory.
11
12	## Official SDKs
13
14	All code samples use the official SDKs:
15
16
17	\| Language \| Package \| Class \| Install \|
18	\| ---------- \| -------------------------- \| ------------- \| ---------------------------------- \|
19	\| Python \| `redis-agent-memory` \| `AgentMemory` \| `pip install redis-agent-memory` \|
20	\| TypeScript \| `@redis-iris/agent-memory` \| `AgentMemory` \| `npm add @redis-iris/agent-memory` \|
21
22
23	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.
24
25	## When to Apply
26
27	Reference these guidelines when:
28
29	- Creating a memory service on Redis Cloud ([https://cloud.redis.io/#/agent-memory](https://cloud.redis.io/#/agent-memory))
30	- Wiring an agent to call `AgentMemory.add_session_event(...)` / `addSessionEvent(...)`
31	- Searching long-term memory with `search_long_term_memory(...)` / `searchLongTermMemory(...)`
32	- Choosing between session events and direct long-term memory writes
33
34	## Rule Categories by Priority
35
36
37	\| Priority \| Category \| Impact \| Prefix \|
38	\| -------- \| ----------------------- \| ------ \| ------------ \|
39	\| 1 \| Setup & Cloud Service \| HIGH \| `setup-` \|
40	\| 2 \| Session Memory / Events \| HIGH \| `session-` \|
41	\| 3 \| Long-Term Memory \| HIGH \| `ltm-` \|
42	\| 4 \| Memory Promotion \| MEDIUM \| `promotion-` \|
43
44
45	## Quick Reference
46
47	### 1. Setup & Cloud Service (HIGH)
48
49	- [`setup-cloud-service`](references/setup-cloud-service.md) - Create a Memory service on Redis Cloud
50	- [`setup-auth-token`](references/setup-auth-token.md) - Authenticate the SDK with a store API key
51
52	### 2. Session Memory / Events (HIGH)
53
54	- [`session-when-to-use`](references/session-when-to-use.md) - Choose session events vs direct long-term memory
55	- [`session-add-event`](references/session-add-event.md) - Append a session event correctly
56	- [`session-retrieval`](references/session-retrieval.md) - Retrieve session memory and individual events
57
58	### 3. Long-Term Memory (HIGH)
59
60	- [`ltm-bulk-create`](references/ltm-bulk-create.md) - Create long-term memories in bulk with idempotent IDs
61	- [`ltm-search`](references/ltm-search.md) - Search long-term memory semantically with filters
62	- [`ltm-organize`](references/ltm-organize.md) - Organize records with namespace, ownerId, topics, and memoryType
63
64	### 4. Memory Promotion (MEDIUM)
65
66	- [`promotion-overview`](references/promotion-overview.md) - How background promotion works
67
68	## How to Use
69
70	Read individual rule files under `references/` for detailed explanations and code examples:
71
72	```
73	references/setup-cloud-service.md
74	references/session-add-event.md
75	references/promotion-overview.md
76	```
77
78	Each rule file contains:
79
80	- Brief explanation of why it matters
81	- Correct example(s) with Python and TypeScript SDK code
82	- Either an "Incorrect" example or "When to use / When NOT needed" guidance
83	- Additional context and references

People who liked this also viewed

6 picks

Type