大模型受上下文窗口限制，跨会话无法保留记忆，导致每次对话都从零开始。记忆库通过自动提取对话中的关键信息并持久化存储，使智能体能够跨会话持续引用用户偏好和历史信息，提供个性化、连贯的对话体验。
概述
记忆库是一种为大模型提供跨会话长期记忆的服务。它自动从对话中提取关键信息并持久化存储为事实记忆和用户画像，在后续对话中基于语义检索相关记忆并注入上下文，使智能体持续理解用户偏好和历史信息。
- 事实记忆：从对话中自动提取的关键事件和信息，如"用户每天上午 9 点需要喝水提醒"。适用于动态事件信息。
- 用户画像：基于自定义模板提取的结构化属性，如年龄、职业、爱好。适用于固定用户属性。
快速开始
通过 API 3 步即可完成记忆的写入、查看和检索，参见快速开始。写入的记忆可在百炼控制台默认记忆库的记忆详情标签页，输入记忆实体 ID（user_id）后点击查看进行确认。
创建记忆库
每个用户账号下自带一个默认记忆库，无需创建即可直接使用。默认记忆库无法删除，但可以编辑名称和描述、添加自定义记忆规则；它已预置一条"默认项目"事实记忆规则，默认有效期 180 天，可点击编辑调整。
如需自定义记忆规则或为不同业务场景分别管理记忆，可创建新的记忆库：
- 进入创建入口：在记忆库页面，点击右上角的创建记忆库。
- 填写基础信息：填写记忆库名称和记忆库描述（可能用于指导智能体调用），点击确定完成创建。
- 配置记忆规则：创建成功后，系统会提示是否立即开始创建记忆规则。推荐点击立即创建，跳转到记忆规则配置页面；也可点击暂不，后续通过记忆库卡片上的查看详情进入配置。
... 图标，或在记忆库详情页右上角点击 ... 图标，再点击删除。删除后记忆库中的所有记忆内容将被清除且不可恢复；默认记忆库不可删除。
详细说明参见创建与删除记忆库。
配置记忆规则
记忆规则定义了如何从对话中提取、存储和检索记忆，包括事实记忆规则和用户画像规则。每个记忆库最多可配置 50 条事实记忆规则和 50 条用户画像规则。点击记忆库卡片的查看详情，进入记忆库详情页的记忆规则标签页进行配置。
- 事实记忆规则：从对话内容中提取关键事件和信息片段，可配置规则指令、自动更新、记忆过期时间和记忆抽取策略版本（Pro/Lite）。
- 用户画像规则：持久化存储用户的属性信息，需逐个定义画像字段的名称、描述、初始值和记忆抽取策略版本。
查看记忆与检索调试
在记忆库详情页的记忆详情标签页，可查看记忆库基本信息、统计数据和记忆实体列表，支持通过记忆实体 ID（user_id）筛选并查看记忆详情。
在记忆检索标签页可调试检索效果。通过 API 调试时，调用 /memory_nodes/search，用 messages 提供对话记录，使用 top_k 控制最大召回数量；min_score 是 Pro 版本生效的最小分数阈值，默认值为 0.3。
通过 API 管理记忆（列表、更新、删除）参见管理记忆。
使用用户画像
通过 API 创建画像模板后，调用 AddMemory 时传入画像模板 ID（profile_schema），系统会自动从对话中提取结构化属性，再通过 GetUserProfile 获取用户画像。完整流程参见使用用户画像。