iris-development

Integrate Redis Agent Memory for session events and long-term memory in AI agents.

Updated Jul 25, 2026
One-click install
npx skills add https://github.com/kaannakiin/turborepo_template --skill iris-development-kaannakiin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iris-development
Source: https://github.com/kaannakiin/turborepo_template/tree/main/.agents/skills/iris-development
Command: npx skills add https://github.com/kaannakiin/turborepo_template --skill iris-development-kaannakiin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires redis-agent-memory, @redis-iris/agent-memory, and includes references (resource) components.

What problem does it solve? Building AI agents that remember users across conversations requires managing two memory tiers — raw session history and semantically searchable long-term facts — plus the async promotion pipeline between them. This Skill provides the correct patterns for provisioning, authenticating, writing, and searching Redis Agent Memory on Redis Cloud without common pitfalls like duplicate records, lost turn order, or flaky tests. ## Core Features & Use Cases - Session Memory Management: Append conversation events with correct session IDs, roles, and tz-aware UTC timestamps, and retrieve sessions or individual events efficiently. - Long-Term Memory Operations: Bulk-create up to 100 memories with idempotent IDs, organize them with ownerId, namespace, topics, and memoryType, and search semantically with structured filters and pagination. - Background Promotion Handling: Understand the 5-minute deduplication window and eventual-consistency model so tests poll instead of asserting synchronously. - Use Case: You are wiring a support chatbot to remember each customer's preferences. Use this Skill to append every turn as a session event, let promotion extract durable facts, and recall them later with an ownerId-scoped semantic search. ## Quick Start Ask the AI to set up the Redis Agent Memory SDK and write code that appends a session event and searches long-term memory for a user.

Frequently Asked Questions about iris-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add session memory to an AI agent with Redis?

Use AgentMemory.add_session_event (Python) or addSessionEvent (TypeScript) with a stable session_id, actor_id, role, content, and a tz-aware UTC timestamp. The session is created on first write, and each event enqueues a background promotion job.

How do I search long-term memory in Redis Agent Memory?

Call search_long_term_memory with a query text plus structured filters on owner_id, namespace, topics, or memory_type. Set a similarity threshold around 0.7 and paginate with the opaque next_page_token rather than filtering client-side.

Should I use session events or long-term memory for conversation history?

Use session events for raw conversation turns; they are cheap, ordered, and session-scoped. Write long-term memory directly only for pre-known structured facts, and let background promotion extract durable facts from sessions automatically.

Why does my long-term memory search return nothing right after writing a session event?

Promotion is asynchronous and eventually consistent. Events are grouped into 5-minute deduplication windows before an LLM extracts facts, so poll search_long_term_memory with a timeout instead of asserting synchronously in tests.

How do I avoid duplicate long-term memories on retries?

Supply a deterministic client-generated id for each record in bulk_create_long_term_memories, which accepts up to 100 records per call. Retrying with the same id is idempotent, and the response splits results into created ids and per-id errors.

What SDKs and credentials does Redis Agent Memory require?

Use the redis-agent-memory Python package or @redis-iris/agent-memory TypeScript package. Both read the bearer token from AGENT_MEMORY_API_KEY and the store ID from AGENT_MEMORY_STORE_ID, with the data-plane URL shown in the Redis Cloud console.