使用 Redis Agent Memory 为你的 Vercel AI SDK 智能体赋予记忆能力
内容提要
Redis 发布开源包 @redis/vercel-ai-sdk，为基于 Vercel AI SDK 的智能体接入 Redis Agent Memory 托管记忆层，提供短期会话记忆与跨会话长期记忆。该记忆层在后台自动摘要长会话、提取并存储长期记忆，并支持语义搜索召回。提供自动记忆包装与模型自主调用工具两种模式，要求 Node.js 22+、AI SDK 7.x、Zod 4.x，采用 MIT 许可。
延伸解读
两种记忆模式如何选择
文章给出明确取舍：automatic-memory 模式在每次模型调用前后自动恢复会话、召回长期记忆并记录消息，适合无需额外提示词即可获得连续性的场景；memory.tools() 则把搜索、保存、更新、遗忘等操作交给模型自主决定，适合需要精细控制记忆管理的场景。两者可共存，但同一交互中不要同时启用自动记录和会话写入工具，否则事件可能重复。
记忆层在请求热路径上的设计约束
由于记忆位于每个请求的关键路径上，文章强调该层保持有界且可预测，并提到 userId、sessionId 和 onDiagnostic 等参数。这意味着接入时需关注每次调用注入的上下文规模与诊断信息，而不是把记忆当作无成本的附加功能。对于延迟敏感的应用，理解这一约束有助于评估是否采用自动包装模式。
接入前的环境与部署要求
该包为服务端、仅 ESM，要求 Node.js 22+、AI SDK 7.x 和 Zod 4.x。使用前需在 Redis Cloud 中创建存储，并在服务端环境设置 AGENT_MEMORY_URL、AGENT_MEMORY_API_KEY 和 AGENT_MEMORY_STORE_ID。这些硬性条件意味着旧版 Node 或 CommonJS 项目需要先升级或调整构建方式，不能直接套用。
Q&A
Redis 新发布的 @redis/vercel-ai-sdk 包有什么作用？
@redis/vercel-ai-sdk 是一个开源包，为基于 Vercel AI SDK 构建的智能体添加 Redis Agent Memory 托管记忆层，提供短期会话记忆和跨会话长期记忆。
Redis Agent Memory 如何实现长期记忆？
Redis Agent Memory 在后台自动摘要长会话、从记录的事件中提取持久记忆并提升到长期存储，之后通过语义搜索召回，让智能体记住用户偏好。
使用 @redis/vercel-ai-sdk 有哪两种模式？
有两种模式：自动记忆模式（automatic-memory）和工具模式（memory.tools()）。自动记忆模式在每次模型调用前后自动恢复会话、注入长期记忆并记录交互；工具模式返回 AI SDK 工具映射，由模型自主决定何时搜索、保存、更新或遗忘记忆。
自动记忆模式和工具模式可以同时使用吗？
可以共存，但不要对同一交互同时启用自动记录和会话写入工具，否则事件可能会重复。
使用这个包需要满足哪些环境要求？
需要 Node.js 22+、AI SDK 7.x 和 Zod 4.x，包是服务器端 ESM-only，采用 MIT 许可。
如何配置 Redis Agent Memory 的连接？
在 Redis Cloud 中创建存储，然后在服务器环境设置 AGENT_MEMORY_URL、AGENT_MEMORY_API_KEY 和 AGENT_MEMORY_STORE_ID 三个环境变量。
