iris-development

Iris：Redis Agent Memory

Iris 是 Redis 面向 AI 产品的统称。本技能目前涵盖该系列中的一款产品：Redis Agent Memory（RAM）——AI Agent 的持久化记忆层，以 Redis Cloud 上的托管服务形式提供。其他 Iris 产品发布后，将作为单独的章节添加。

Redis Agent Memory 提供 REST/JSON 数据平面 API，包含两个记忆层：

• 会话记忆 — 每个会话仅追加的对话历史（工作记忆）。
• 长期记忆 — 从会话中提取（或直接创建）的、可进行语义搜索的记录。

由 Redis Cloud 管理的后台 提升工作进程会从会话事件中提取持久事实，并将其写入长期记忆。

官方 SDK

所有代码示例均使用官方 SDK：

语言	包	类	安装
Python	redis-agent-memory	AgentMemory	pip install redis-agent-memory
TypeScript	@redis-iris/agent-memory	AgentMemory	npm add @redis-iris/agent-memory

两个 SDK 都会从 AGENT_MEMORY_API_KEY 读取 bearer token，并从 AGENT_MEMORY_STORE_ID 读取默认存储 ID。生产环境的数据平面 URL 为 https://gcp-us-east4.memory.redis.io；服务的确切 URL 也会在配置完成后显示于 Cloud 控制台中。

何时使用

在以下场景中参考这些指南：

• 在 Redis Cloud 上创建记忆服务（https://cloud.redis.io/#/agent-memory）
• 配置 Agent 调用 AgentMemory.add_session_event(...) / addSessionEvent(...)
• 使用 search_long_term_memory(...) / searchLongTermMemory(...) 搜索长期记忆
• 在会话事件和直接写入长期记忆之间进行选择

按优先级划分的规则类别

优先级	类别	影响	前缀
1	设置与 Cloud 服务	高	setup-
2	会话记忆 / 事件	高	session-
3	长期记忆	高	ltm-
4	记忆提升	中	promotion-

快速参考

1. 设置与 Cloud 服务（高）

• setup-cloud-service - 在 Redis Cloud 上创建记忆服务
• setup-auth-token - 使用存储 API 密钥对 SDK 进行身份验证

2. 会话记忆 / 事件（高）

• session-when-to-use - 选择会话事件或直接写入长期记忆
• session-add-event - 正确追加会话事件
• session-retrieval - 检索会话记忆和单个事件

3. 长期记忆（高）

• ltm-bulk-create - 使用幂等 ID 批量创建长期记忆
• ltm-search - 使用筛选条件对长期记忆进行语义搜索
• ltm-organize - 使用 namespace、ownerId、topics 和 memoryType 整理记录

4. 记忆提升（中）

• promotion-overview - 了解后台提升的工作方式

使用方法

如需详细说明和代码示例，请阅读 references/ 下的各个规则文件：

references/setup-cloud-service.md
references/session-add-event.md
references/promotion-overview.md

每个规则文件包含：

• 简要说明其重要性
• 使用 Python 和 TypeScript SDK 的正确示例
• “错误”示例，或“何时使用 / 何时不需要”的指南
• 补充背景信息和参考资料