用户在上一次会话中说明过的偏好和背景，不会自动延续到下一次会话。AgentLoop 记忆库（MemoryStore）为 AI 智能体（Agent）提供持久化的记忆能力，用于保存用户偏好、重要事实和可复用的上下文。应用通过 mem0 兼容接口写入对话，在后续交互中检索相关记忆，并将结果提供给智能体，帮助服务保持连续性。
为什么需要记忆库
在新的会话中，智能体通常只能使用应用提供给它的上下文。如果应用没有带入历史信息，用户就需要重新说明自己的背景、偏好和要求。例如，用户已经告诉助手“我喜欢清淡、少辣的菜”，下一次询问晚餐建议时，仍可能需要重复这一偏好。随着交互增加，每次携带完整历史也会带入许多与当前问题无关的内容。记忆库将对话中可复用的信息沉淀下来，让应用根据当前问题检索相关背景，再组织本次请求的上下文。
核心概念
概念 | 说明 | 示例 |
记忆库 | 管理记忆数据的资源，在智能体空间中创建，通过对应的 API Key 接入应用 | 为烹饪助手创建 |
对话消息（短期记忆） | 应用写入的原始交互内容，可作为记忆提取的输入 | 用户说“我喜欢清淡、少辣的菜”，助手作出回复 |
长期记忆 | 从交互内容中提取、供后续检索复用的信息 | 用户偏好清淡、少辣的饮食 |
用户标识 | 应用为业务用户设置的标识，用于关联和检索该用户的记忆，在控制台检索时对应用户 ID | 写入和检索时均使用 |
上表中的示例仅用于说明概念。
记忆库如何工作
从对话到后续回答，通常包含以下环节：
写入对话：应用将用户与助手的消息发送到记忆库，并关联用户标识。
提取记忆：在写入请求中将
infer参数设为true，提取对话中的可复用信息，形成长期记忆。实际提取出的文字和条目数以检索结果为准，对话中的一句话与一条长期记忆不一定一一对应。检索相关背景：用户提出新问题时，应用使用查询语句和相应的用户标识检索相关记忆。
组织上下文：应用选择与本次问题有关的记忆，与当前问题、必要的近期对话一起提供给智能体。
继续积累信息：本轮对话结束后，应用可以写入新的交互内容，供后续处理和检索。
创建记忆库后，应用还需要接入写入和检索流程，并负责将检索结果加入模型请求。记忆写入成功、长期记忆能够被检索到、智能体在回答中使用这些记忆，是三个需要分别验证的环节。其中，长期记忆能否被检索到，可以通过控制台的长期记忆检索功能确认。
典型应用场景
记忆库适合解决以下问题：
保持跨会话的连续性：在新的交互中复用用户已经提供的背景，减少重复询问。
提供个性化服务：将用户的表达习惯、兴趣和偏好作为回答参考。
为当前任务补充背景：围绕当前问题检索相关信息，帮助智能体理解用户的具体需求。
不同场景下适合积累的信息和后续使用方式如下：
场景 | 适合积累的信息 | 后续使用方式 |
个人生活助手 | 饮食口味、出行偏好、日常习惯 | 生成建议前，检索与当前请求有关的偏好 |
客户服务助手 | 用户主动提供的产品使用背景和服务偏好 | 新会话中补充背景，减少重复确认 |
学习助手 | 用户正在学习的主题、目标和讲解偏好 | 在答疑时调整讲解重点和表达方式 |
工作助手 | 用户关注的业务主题、输出格式和沟通习惯 | 生成简报或分析结果时参考用户要求 |
例如，烹饪助手可以按以下方式使用记忆：
交互阶段 | 用户或应用的操作 | 记忆发挥的作用 |
首次交流 | 用户说明“我喜欢清淡、少辣的菜” | 应用写入对话，积累饮食偏好 |
再次咨询 | 用户在新会话中询问“今晚吃什么？” | 应用检索该用户的饮食偏好 |
生成建议 | 应用将相关偏好加入本次请求的上下文 | 智能体结合偏好和当前问题给出建议 |
记忆为回答提供参考。用户在当前请求中提出的新要求，也应由应用一并提供给智能体，避免只依赖历史信息。
控制台功能
控制台支持资源管理、检索与验证、接入集成三类操作：
类别 | 功能 | 使用方式 |
资源管理 | 创建记忆库 | 填写记忆库名称和可选的描述信息 |
资源管理 | 查看概览 | 查看名称、描述、创建时间和更新时间等基础信息 |
资源管理 | API Key 管理 | 创建供外部应用访问该记忆库的 API Key |
检索与验证 | 长期记忆检索 | 输入查询语句和 topK，并按用户 ID、App ID、Agent ID、Run ID 限定检索范围 |
接入集成 | 应用集成 | 查看并复制 HTTP API 或 Python SDK 接入示例 |
记忆的写入和检索通过 mem0 兼容接口完成，具体 Endpoint、调用方法和参数以目标记忆库集成方式页签提供的示例为准。
接入准备
接入记忆库前，需要完成以下准备：
在智能体空间中创建记忆库。
创建供外部应用访问该记忆库的 API Key。
在目标记忆库的集成方式页签获取接入示例。
完成准备后，建议先选择一个具体场景，用一段明确表达偏好的示例对话完成写入和检索，再将检索结果接入智能体的回答流程。记忆库使用指南提供操作步骤、HTTP 写入示例、用户标识使用建议和常见问题。