做AI应用一年多我最大的感触是单个对话里大模型聪明得吓人可换个会话它就翻脸不认人——完全不记得你是谁聊过什么喜欢什么。这也是我一直在琢磨ai-memory的原因。说白了我们缺的不是一个“高智商金鱼”而是一个有连续记忆、越用越懂你的助手。这篇文章把我从设计、实现到上线过程中关于AI记忆功能的经验完整梳理一遍包括记忆怎么存、怎么取、怎么避免数据脏掉以及那些不跑一遍根本发现不了的坑。1. 为什么AI应用需要“记忆”能力1.1 大模型的“金鱼病”上下文窗口与会话隔离先聊一个很反直觉的现象GPT级别的模型在单次对话里表现确实惊艳但如果你把同一个用户的问题分散到多个会话里模型根本不会记得前一次发生过什么。原因有两个层面。第一是上下文窗口限制。模型能处理的是固定的token数量几千到几万不等。这不是说窗口越长越好窗口越长推理成本越高响应延迟越大而且过长的输入反而会让模型“注意力稀释”——开头的内容到了后半截已经变得模糊。真实用户的使用习惯是碎片化的今天问猫粮明天问猫砂一周后问猫咳嗽怎么办。把这一周的聊天记录全塞进上下文窗口既浪费又低效。第二是会话隔离机制。当前几乎所有对话产品都是按session隔离的每个会话相当于一个干净的房间模型根本不共享之前房间里的信息。这短期内是安全设计但长期看就是用户体验的硬伤。我当时做AI健康助手的记忆模块时用户问得最多的一个问题是“我上次跟你说我对青霉素过敏你怎么还推荐含青霉素的药”这就是典型的记忆缺失。单靠上下文窗口没法解决必须引入独立的记忆层。1.2 记忆的真实需求场景拆解在动手做ai-memory之前我先把需求场景拆了一遍。记忆不是简单地把聊天记录存下来而是分场景地满足用户预期。第一类是用户画像类记忆。包括姓名、年龄、职业、居住地、健康状况、饮食偏好。这类事实型的记忆稳定性最高通常聊一次就能长期复用。比如用户说过“我有乳糖不耐”“我在备孕”“我每天通勤两小时”这些信息会在未来无数次对话中影响模型回答的倾向。第二类是任务与状态类记忆。比如用户当前正在减肥、正在准备雅思、正在做某项目或者某个任务已经做到了哪一步。这类记忆有生命周期需要在任务结束后或被新信息覆盖时及时更新。第三类是偏好类记忆。用户喜欢简洁的回答还是详细的分析喜欢表格还是列表喜欢中文还是中英混排。这种风格偏好很难被用户主动说出来但通过对话历史能很自然地推测出来。这三类记忆的更新频率不同存储方式也不同强行混在一个表里后面调优会非常痛苦。1.3 记忆不是聊天记录的“备份”这是我最想强调的一点把对话日志导出成全文再靠模型去“通读”找信息那不叫记忆那叫事后翻账本。真正的Memory必须是结构化的、可检索的、可更新的。打个比方人脑不会把从出生到现在所有画面都放电影一样重放一遍。我们会提取出“妈妈做的红烧肉很好吃”这个语义片段而不是备份厨房里的每一帧画面。AI的记忆也应该这样做——从原始对话中抽取关键信息存成结构化条目需要的时候按相关性取出极少量注入上下文。决定做记忆系统之前我建议你先想清楚这三件事记忆要服务哪些场景记忆的规模预期有多大以及你能接受怎样的数据丢失。这三个问题的答案决定了后续所有技术选型。我当时因为没有考虑规模预期第一版方案在数据量涨到几十万条后彻底吃亏这个坑后面详说。2. 整体架构设计把记忆拆成四层2.1 分层架构短期窗口、抽取层、存储层、召回层我的记忆模块最终采用了一个四层架构并不是什么“行业标准方案”而是基于成本和灵活的折中选择。第一层是短期窗口层。保留最近一轮或几轮对话原文用于模型即时响应当前语境。这其实是模型自带上下文窗口的用法我们的记忆系统会把它控制在最小必要范围。第二层是抽取层。这是记忆系统的“大脑”定期从对话原文中调用LLM把无结构的对话转成结构化的记忆条目。这一步是整个系统的关键它决定你存进记忆库的是金子还是沙子。第三层是存储层。记忆条目经过向量化后写入向量数据库同时保留结构化字段方便按用户、按类型筛选和更新。第四层是召回层。在每次新对话进来时把当前问题向量化在向量库中检索相关记忆拼进system prompt实现“模型想起来”的效果。这个四层结构的好处是每一层都可以独立升级和替换。比如今天用Chroma做向量库明天想换Milvus只动存储层的接口其他三层完全不受影响。2.2 为什么不用“全文RAG”直接处理历史记录有人问我既然有RAG为什么不直接把历史聊天记录分块向量化检索后拼给模型这个问题我实际比较过。全文分块RAG适合知识性内容的检索比如文档问答、知识库搜索。但用在“人设型记忆”上效果不太好。原因是两点。第一聊天记录里的信息密度极低十句日常闲聊可能只有一句包含值得长期记忆的事实。把它全部向量化检索时会召回大量无关内容噪声比信号还大。第二聊天记录里有重复、矛盾、过时的信息。用户半年前说的体重和现在的体重完全可能是两个数字直接检索会导致模型答出过时的内容。抽取层解决了这两个问题它先过滤掉废话把信息浓缩成简洁的记忆条目在抽取过程中模型可以通过提示词判断哪些是全新的、哪些是已经记录过的变体从入口处做了初步去重。2.3 存储字段设计只有向量是不够的很多人提起向量检索就兴奋觉得只要把内容embedding一下存进去就完事了。实际跑起来你会发现只有向量根本不够用。我最终使用的记忆条目结构包含这些字段字段名类型说明idstring主键UUIDuser_idstring用户标识用于严格隔离contenttext记忆内容本身比如“用户对青霉素过敏”memory_typeenum用户画像/任务状态/偏好风格等source_timedatetime原始对话时间用于时间衰减排序created_atdatetime入库时间updated_atdatetime最近更新时间ref_countint被成功引用的次数用于热记忆管理embeddingvector内容向量维度取决于所用模型user_id字段是重中之重。多用户系统的数据隔离靠的就是它。检索时的过滤器必须带上user_id否则跨用户召回的是灾难性的隐私泄露。memory_type字段用来支持差异化策略比如用户画像型记忆永不自动过期任务状态型记忆在任务结束后会被标记失效偏好型记忆则需要定期用最新对话验证。embedding字段存储的是向量本身。有些团队会把向量和结构化字段分开存比如把结构化信息放PostgreSQL向量放Milvus中间用id关联。我前期偷懒没有做这个拆分导致一些复杂的过滤查询只能把全量向量拖回客户端过滤效率感人。如果是从零开始我更推荐从第一天就双写一份在关系库做业务查询一份在向量库做相似度检索。3. 核心实现记忆写入与召回全流程3.1 环境与依赖准备这部分给你一个可以直接复现的最小化方案。我开发环境的版本是Python 3.10LLM调用用的是OpenAI SDK兼容接口向量库用了Chromaembedding模型用了text-embedding-3-small。依赖清单如下pip install openai chromadb tiktoken pydanticChroma是一个本地内嵌式的向量库对中小项目非常友好。不需要单独起服务用pip install chromadb就能跑起来支持持久化存储适合做MVP。如果你的项目预估数据量会超过几百万条向量或者需要分布式部署那时候再换到Milvus或Qdrant也来得及。但我建议第一步不要直接上重武器Chroma迭代速度快调试成本低。3.2 记忆写入从对话中抽取结构化条目记忆写入的核心逻辑是拿到一段对话历史让LLM输出JSON格式的候选记忆条目校验后写入向量库。我用的抽取提示词结构大致是这样的system_prompt 你是一个记忆抽取系统。你的任务是从用户和AI的对话中抽取值得长期记忆的信息。 只抽以下三类 1. user_fact: 关于用户的客观事实如身份、健康状况、过敏史、家庭情况 2. user_preference: 用户表达的个人偏好如喜欢简洁回答、喜欢喝咖啡 3. task_state: 用户当前在做的事情及进度如正在备考雅思已完成单词背诵阶段 输出要求 - 只输出JSON格式为 {memories: [{type: ..., content: ..., info: ...}]} - content必须是完整的陈述句尽量包含具体实体 - 如果某条信息在历史上已存在但表述不同不要重复输出用info字段标注“update” - 不要抽取调安全无关的闲聊内容 需要注意抽取提示词里明确要求LLM输出“完整陈述句”而不是“用户名字叫小刘”这种片段。原因是后续检索时简洁陈述句的相似度匹配效果优于碎片化短语。比如用户说过“我每次喝咖啡心脏就跳得特别快”存成“用户喝咖啡后心悸”比存成“咖啡 心脏”有用得多。写入流程的伪代码如下def extract_and_store_memories(conversation, user_id): # 1. 调用LLM抽取 response llm.chat([...system_prompt..., ...conversation...]) memories parse_json(response) # 2. 按类型过滤和去重 for mem in memories: if mem.type task_state: # 对同类型旧任务标记失效 deactivate_old_task_memories(user_id, content_hash) # 3. 向量化并入库 vector embed(mem.content) save_memory(user_id, mem.type, mem.content, vector)抽取时机我推荐放在一轮对话结束后异步执行不要放在模型返回响应的同步链路里。理由很简单抽取调用会有额外延迟用户正在打字等着回复你这一来一回多出两三秒体验立刻崩了。3.3 记忆召回让模型在关键时刻“想起来”召回的流程是每当用户发来一条新消息先把这句话embedding再到向量库里按user_id过滤后的集合中做相似度检索取top_k条记忆拼到system prompt里。def recall_memories(query, user_id, top_k5): query_vector embed(query) results collection.query( query_embeddings[query_vector], where{user_id: user_id}, n_resultstop_k, include[documents, metadatas, distances] ) return format_for_prompt(results)拼进prompt时我用的模板是以下是关于用户的记忆信息你在回答问题时必须参考 [记忆1] 用户有乳糖不耐受避免推荐含牛奶制品 [记忆2] 用户正在减脂期热量建议控制在1500千卡/天 [记忆3] 用户偏好简洁的回答不要超过5个要点这看起来简单但有几个细节非常影响效果。第一相似度阈值必须设。实测下来如果把top_k5的检索结果不管相似度多低都拼进prompt模型会把无关内容当背景噪声硬融进回答里导致回答变得莫名其妙。我用的阈值是相似度低于0.3的直接丢弃。不同embedding模型对余弦相似度打分习惯不一样你需要先做一个小的验证集找一找合适的边界。第二top_k不能贪心。我一开始设过top_k20想着多给些信息让模型发挥。结果模型反而在细节上出现幻觉甚至把两条其实不相干的记忆互相串烧。后来我把风格偏好类的记忆单独设置了一个小池子回答风格类记忆永远优先注入但总条数控制在6条以内。第三时间衰减要有度。老记忆不代表无价值。我采用的排序是最终得分余弦相似度0.7时间权重0.3这样即时是三个月前的事实只要相似度高依然能被检索到。不加时间权重的话新版记忆很容易被淹没在历史噪音里。3.4 关键参数选型与调优经验这里整理一下我在实际项目中用到的参数组合供参考。参数我的取值说明embedding模型text-embedding-3-small性价比高1536维对中文效果可接受向量库Chroma适合百万级以下规模检索方式余弦相似度先统一归一化再算点积top_k5-8根据prompt长度和任务类型动态调整相似度阈值0.3向量库内归一化前不同模型差异大需实测校准抽取频率每轮对话结束触发异步处理不阻塞主链路记忆最大条数/用户500条超过后按ref_count和recency淘汰关于embedding模型我再多说一句。对中文场景你完全可以用开源的BGE或者M3E模型效果并不差。选择text-embedding-3-small只是因为它API调用省心。如果你是在本地部署别把模型跑在CPU上embedding单条耗时虽然只有几十毫秒但并发量上来CPU就瞬间打满。我后来把embedding服务独立部署到一台小GPU机器上整个系统的P99延迟才恢复正常。提示无论是哪个embedding模型正式上线前至少要准备200个不同领域的真实查询测试一下相似度分数分布区间。同一个正值余弦0.5在某些模型里是高度相关在另一些模型里可能是完全不相关。不校准就设阈值的后面检索效果全凭运气。4. 实际运行中的问题排查与优化实录4.1 高频问题速查表我把记忆系统上线以来被问最多的问题整理成一张表方便直接对照。问题典型原因解决方案模型完全不“记得”用户召回阶段返回条数始终为0检查user_id过滤是否生效检查embedding维度一致性注入记忆后回答出幻觉top_k过大或阈值过低减少top_k提高阈值压缩记忆条目长度旧记忆覆盖新事实失败抽取层没有识别到同一实体的信息更新时间增加实体归一化步骤对同一主体做updated_at覆盖同一个记忆反复写入几百次抽取层没做语义级去重写入前做一次向量近重复检测相似度0.85则视为重复多用户间串数据召回时忘了带user_id过滤全局检查recall函数强制where条件为必填参数记忆库膨胀严重抽取粒度太细一点事就存一条合并同类记忆控制每类记忆的容量上限检索延迟突然飙升向量库全量扫描加索引类型为HNSW并把collection按用户分片其中“旧记忆覆盖新事实失败”是我最头疼的一个问题。用户上周说他“每天喝三杯咖啡”这周说“医生建议我别再喝咖啡了”。如果只做新增老的“每天喝三杯咖啡”依旧会被召回模型就会在同一个回答里给出自相矛盾的建议。我从抽取提示词入手要求模型遇到同一实体的新取值时必须输出{type: user_fact, content: ..., replace_target: 用户每天喝三杯咖啡}系统收到replace_target后在库里精确查找并做替换。4.2 三个印象深刻的踩坑记录第一个坑是embedding维度不一致。开发时我用的embedding模型输出1024维部署时切换到了另一个模型输出1536维结果库里已有数据向量长度和新查询向量长度不一致。Chroma报错还不太明显检索结果直接退化成随机排序。排查了半天才发现是模型版本不一致。这个问题的教训是embedding模型一旦确定就不要随便换实在要换必须全量重算向量没有捷径。第二个坑是相似度阈值的“幻觉”。我用了text-embedding-3-small之后用一套开发集评估发现相似度0.8以上的内容基本都是同义句0.5-0.8区间里混着大量表面相关但语义偏离的片段。当时把阈值定在0.6结果上线后用户反馈“AI忘性还是很大”。后来仔细分析了一批真实Query发现大量真实相关的对话在向量空间里相似度只有0.4出头因为口语化的表达方式跟书面陈述差太远。最终把阈值降到0.3召回率立刻上去噪声率也很低。第三个坑是同步链路的副作用。最早版本我把记忆抽取放在用户点击发送之后模型回答之后串行执行。用户平均响应时间从1.8秒涨到4.5秒。架构调整成异步化之后主路径不再等待抽取完成用户侧响应时间直接回到1.5秒。教训很简单凡是和用户主流程无关的耗时间操作一律丢后台队列。4.3 性能优化从百次到万次调用的压力应对不同阶段的性能瓶颈完全不同。初期几百次daily active用户的调用量Chroma单机完全能扛住瓶颈只在embedding这一环。当时embedding接口的并发上限是每分钟几千次完全够用。这个阶段别过早优化浪费时间。到了几千daily active用户时问题开始出现在检索层面。每次对话召回都需要做embedding向量检索LLM抽取如果没有缓存一次对话会产生3-5次外部API调用。我加了三个缓存手段第一查询向量结果按用户级缓存热点Query命中率大约30%第二记忆抽取只针对“有实质新信息”的对话触发通过关键词和消息长度做一个轻量预筛过滤掉70%无抽取价值的日常寒暄第三embedding结果本身做layer缓存相同句子直接取缓存向量。到了上万级调用我发现向量库的写入频繁导致检索毛刺原因是在线写入触发HNSW图的重建。后来把写入分成了两个阶段实时消息先写入消息表延迟5秒批量转换并写入向量库。既保证了写入吞吐又避免阻塞检索路径。5. 隐私、安全与产品化绕不开的边界5.1 记忆功能必须给用户“删除权”记忆功能的本质是把用户的私密信息长期化存储这本身就是一件需要谨慎对待的事。我上线的第一版因为只顾功能没想到用户会主动查看自己的记忆条目。结果有一个用户发现AI记住了他半年前提过的一个健康问题非常不满觉得“你们凭什么存这个”。后来我专门加了一个“记忆管理面板”用户能看到所有与自己关联的记忆条目支持逐条删除还有一键清空所有记忆的入口。这个功能带给用户的信任感远超预期。我的建议是做记忆功能的同时删除权要作为一等公民公民功能来设计不要等被用户投诉了再补。另外记忆库数据本身要做加密存储。向量库里的向量虽然不像明文那么直观但向量反推文本已经是研究领域验证过的问题不能掉以轻心。5.2 多租户数据隔离的硬性要求如果你做的是SaaS产品多个企业共用同一套系统user_id和tenant_id的隔离是必须验证的。我见过某团队上线后出现A企业的用户对话流到了B企业AI的上下文里事故级别足够直接下架的程度。我的做法存储在检索层强制校验每个涉及记忆的查询必须显式指定当前用户及所属租户不允许出现全局搜索接口。并且在召回结果的prompt组装里会额外加一行“如果上述记忆与当前用户无关请忽略”作为兜底逻辑。5.3 从记忆到知识管理后续的演进方向记忆功能稳定运行之后自然会长出两条演进路线。一条是记忆与外部知识库融合比如把用户的历史健康档案和医疗知识库结合做真正个性化的健康建议而不是靠模型“记住”某句话。另一条是用户主动配置的记忆也就是让用户直接告诉AI“我喜欢什么、不喜欢什么”由系统把这些主动声明设为最高优先级记忆覆盖掉模型自己从对话里推测的弱记忆。在技术架构上下一步可以加一个“记忆版本管理”。当用户改变偏好时不是简单地覆盖旧条目而是保留历史版本。在回答一些敏感问题时模型可以参考旧版本和变更时间给出“你在X月前曾提到A最近更新为B你要不要确认以哪个为准”的交互。这不会增加太多开发工作量但能极大增强用户对记忆功能的掌控感。个人经验补充如果你正在做自己的AI产品我的建议是牢牢掌握两个原则第一记忆系统一定要和主对话流程解耦不要为了让AI“记得”而拖慢用户的每一次交互第二宁可少抽取、多复盘也不要粗暴地把所有历史塞进向量库。我在实践中反复体会到记忆不是越多越好而是越精准越好。一次恰到好处的回忆比十次泛泛的参考更能让用户觉得这个AI“真的懂我”。后面你还会遇到记忆冲突、实体归一化、跨语言检索这些更细腻的问题每一步都有值得记录的教训。先跑通最小闭环别在第一天就想构建完美的记忆宇宙。
AI记忆系统实战：从上下文窗口到向量检索的完整方案
做AI应用一年多我最大的感触是单个对话里大模型聪明得吓人可换个会话它就翻脸不认人——完全不记得你是谁聊过什么喜欢什么。这也是我一直在琢磨ai-memory的原因。说白了我们缺的不是一个“高智商金鱼”而是一个有连续记忆、越用越懂你的助手。这篇文章把我从设计、实现到上线过程中关于AI记忆功能的经验完整梳理一遍包括记忆怎么存、怎么取、怎么避免数据脏掉以及那些不跑一遍根本发现不了的坑。1. 为什么AI应用需要“记忆”能力1.1 大模型的“金鱼病”上下文窗口与会话隔离先聊一个很反直觉的现象GPT级别的模型在单次对话里表现确实惊艳但如果你把同一个用户的问题分散到多个会话里模型根本不会记得前一次发生过什么。原因有两个层面。第一是上下文窗口限制。模型能处理的是固定的token数量几千到几万不等。这不是说窗口越长越好窗口越长推理成本越高响应延迟越大而且过长的输入反而会让模型“注意力稀释”——开头的内容到了后半截已经变得模糊。真实用户的使用习惯是碎片化的今天问猫粮明天问猫砂一周后问猫咳嗽怎么办。把这一周的聊天记录全塞进上下文窗口既浪费又低效。第二是会话隔离机制。当前几乎所有对话产品都是按session隔离的每个会话相当于一个干净的房间模型根本不共享之前房间里的信息。这短期内是安全设计但长期看就是用户体验的硬伤。我当时做AI健康助手的记忆模块时用户问得最多的一个问题是“我上次跟你说我对青霉素过敏你怎么还推荐含青霉素的药”这就是典型的记忆缺失。单靠上下文窗口没法解决必须引入独立的记忆层。1.2 记忆的真实需求场景拆解在动手做ai-memory之前我先把需求场景拆了一遍。记忆不是简单地把聊天记录存下来而是分场景地满足用户预期。第一类是用户画像类记忆。包括姓名、年龄、职业、居住地、健康状况、饮食偏好。这类事实型的记忆稳定性最高通常聊一次就能长期复用。比如用户说过“我有乳糖不耐”“我在备孕”“我每天通勤两小时”这些信息会在未来无数次对话中影响模型回答的倾向。第二类是任务与状态类记忆。比如用户当前正在减肥、正在准备雅思、正在做某项目或者某个任务已经做到了哪一步。这类记忆有生命周期需要在任务结束后或被新信息覆盖时及时更新。第三类是偏好类记忆。用户喜欢简洁的回答还是详细的分析喜欢表格还是列表喜欢中文还是中英混排。这种风格偏好很难被用户主动说出来但通过对话历史能很自然地推测出来。这三类记忆的更新频率不同存储方式也不同强行混在一个表里后面调优会非常痛苦。1.3 记忆不是聊天记录的“备份”这是我最想强调的一点把对话日志导出成全文再靠模型去“通读”找信息那不叫记忆那叫事后翻账本。真正的Memory必须是结构化的、可检索的、可更新的。打个比方人脑不会把从出生到现在所有画面都放电影一样重放一遍。我们会提取出“妈妈做的红烧肉很好吃”这个语义片段而不是备份厨房里的每一帧画面。AI的记忆也应该这样做——从原始对话中抽取关键信息存成结构化条目需要的时候按相关性取出极少量注入上下文。决定做记忆系统之前我建议你先想清楚这三件事记忆要服务哪些场景记忆的规模预期有多大以及你能接受怎样的数据丢失。这三个问题的答案决定了后续所有技术选型。我当时因为没有考虑规模预期第一版方案在数据量涨到几十万条后彻底吃亏这个坑后面详说。2. 整体架构设计把记忆拆成四层2.1 分层架构短期窗口、抽取层、存储层、召回层我的记忆模块最终采用了一个四层架构并不是什么“行业标准方案”而是基于成本和灵活的折中选择。第一层是短期窗口层。保留最近一轮或几轮对话原文用于模型即时响应当前语境。这其实是模型自带上下文窗口的用法我们的记忆系统会把它控制在最小必要范围。第二层是抽取层。这是记忆系统的“大脑”定期从对话原文中调用LLM把无结构的对话转成结构化的记忆条目。这一步是整个系统的关键它决定你存进记忆库的是金子还是沙子。第三层是存储层。记忆条目经过向量化后写入向量数据库同时保留结构化字段方便按用户、按类型筛选和更新。第四层是召回层。在每次新对话进来时把当前问题向量化在向量库中检索相关记忆拼进system prompt实现“模型想起来”的效果。这个四层结构的好处是每一层都可以独立升级和替换。比如今天用Chroma做向量库明天想换Milvus只动存储层的接口其他三层完全不受影响。2.2 为什么不用“全文RAG”直接处理历史记录有人问我既然有RAG为什么不直接把历史聊天记录分块向量化检索后拼给模型这个问题我实际比较过。全文分块RAG适合知识性内容的检索比如文档问答、知识库搜索。但用在“人设型记忆”上效果不太好。原因是两点。第一聊天记录里的信息密度极低十句日常闲聊可能只有一句包含值得长期记忆的事实。把它全部向量化检索时会召回大量无关内容噪声比信号还大。第二聊天记录里有重复、矛盾、过时的信息。用户半年前说的体重和现在的体重完全可能是两个数字直接检索会导致模型答出过时的内容。抽取层解决了这两个问题它先过滤掉废话把信息浓缩成简洁的记忆条目在抽取过程中模型可以通过提示词判断哪些是全新的、哪些是已经记录过的变体从入口处做了初步去重。2.3 存储字段设计只有向量是不够的很多人提起向量检索就兴奋觉得只要把内容embedding一下存进去就完事了。实际跑起来你会发现只有向量根本不够用。我最终使用的记忆条目结构包含这些字段字段名类型说明idstring主键UUIDuser_idstring用户标识用于严格隔离contenttext记忆内容本身比如“用户对青霉素过敏”memory_typeenum用户画像/任务状态/偏好风格等source_timedatetime原始对话时间用于时间衰减排序created_atdatetime入库时间updated_atdatetime最近更新时间ref_countint被成功引用的次数用于热记忆管理embeddingvector内容向量维度取决于所用模型user_id字段是重中之重。多用户系统的数据隔离靠的就是它。检索时的过滤器必须带上user_id否则跨用户召回的是灾难性的隐私泄露。memory_type字段用来支持差异化策略比如用户画像型记忆永不自动过期任务状态型记忆在任务结束后会被标记失效偏好型记忆则需要定期用最新对话验证。embedding字段存储的是向量本身。有些团队会把向量和结构化字段分开存比如把结构化信息放PostgreSQL向量放Milvus中间用id关联。我前期偷懒没有做这个拆分导致一些复杂的过滤查询只能把全量向量拖回客户端过滤效率感人。如果是从零开始我更推荐从第一天就双写一份在关系库做业务查询一份在向量库做相似度检索。3. 核心实现记忆写入与召回全流程3.1 环境与依赖准备这部分给你一个可以直接复现的最小化方案。我开发环境的版本是Python 3.10LLM调用用的是OpenAI SDK兼容接口向量库用了Chromaembedding模型用了text-embedding-3-small。依赖清单如下pip install openai chromadb tiktoken pydanticChroma是一个本地内嵌式的向量库对中小项目非常友好。不需要单独起服务用pip install chromadb就能跑起来支持持久化存储适合做MVP。如果你的项目预估数据量会超过几百万条向量或者需要分布式部署那时候再换到Milvus或Qdrant也来得及。但我建议第一步不要直接上重武器Chroma迭代速度快调试成本低。3.2 记忆写入从对话中抽取结构化条目记忆写入的核心逻辑是拿到一段对话历史让LLM输出JSON格式的候选记忆条目校验后写入向量库。我用的抽取提示词结构大致是这样的system_prompt 你是一个记忆抽取系统。你的任务是从用户和AI的对话中抽取值得长期记忆的信息。 只抽以下三类 1. user_fact: 关于用户的客观事实如身份、健康状况、过敏史、家庭情况 2. user_preference: 用户表达的个人偏好如喜欢简洁回答、喜欢喝咖啡 3. task_state: 用户当前在做的事情及进度如正在备考雅思已完成单词背诵阶段 输出要求 - 只输出JSON格式为 {memories: [{type: ..., content: ..., info: ...}]} - content必须是完整的陈述句尽量包含具体实体 - 如果某条信息在历史上已存在但表述不同不要重复输出用info字段标注“update” - 不要抽取调安全无关的闲聊内容 需要注意抽取提示词里明确要求LLM输出“完整陈述句”而不是“用户名字叫小刘”这种片段。原因是后续检索时简洁陈述句的相似度匹配效果优于碎片化短语。比如用户说过“我每次喝咖啡心脏就跳得特别快”存成“用户喝咖啡后心悸”比存成“咖啡 心脏”有用得多。写入流程的伪代码如下def extract_and_store_memories(conversation, user_id): # 1. 调用LLM抽取 response llm.chat([...system_prompt..., ...conversation...]) memories parse_json(response) # 2. 按类型过滤和去重 for mem in memories: if mem.type task_state: # 对同类型旧任务标记失效 deactivate_old_task_memories(user_id, content_hash) # 3. 向量化并入库 vector embed(mem.content) save_memory(user_id, mem.type, mem.content, vector)抽取时机我推荐放在一轮对话结束后异步执行不要放在模型返回响应的同步链路里。理由很简单抽取调用会有额外延迟用户正在打字等着回复你这一来一回多出两三秒体验立刻崩了。3.3 记忆召回让模型在关键时刻“想起来”召回的流程是每当用户发来一条新消息先把这句话embedding再到向量库里按user_id过滤后的集合中做相似度检索取top_k条记忆拼到system prompt里。def recall_memories(query, user_id, top_k5): query_vector embed(query) results collection.query( query_embeddings[query_vector], where{user_id: user_id}, n_resultstop_k, include[documents, metadatas, distances] ) return format_for_prompt(results)拼进prompt时我用的模板是以下是关于用户的记忆信息你在回答问题时必须参考 [记忆1] 用户有乳糖不耐受避免推荐含牛奶制品 [记忆2] 用户正在减脂期热量建议控制在1500千卡/天 [记忆3] 用户偏好简洁的回答不要超过5个要点这看起来简单但有几个细节非常影响效果。第一相似度阈值必须设。实测下来如果把top_k5的检索结果不管相似度多低都拼进prompt模型会把无关内容当背景噪声硬融进回答里导致回答变得莫名其妙。我用的阈值是相似度低于0.3的直接丢弃。不同embedding模型对余弦相似度打分习惯不一样你需要先做一个小的验证集找一找合适的边界。第二top_k不能贪心。我一开始设过top_k20想着多给些信息让模型发挥。结果模型反而在细节上出现幻觉甚至把两条其实不相干的记忆互相串烧。后来我把风格偏好类的记忆单独设置了一个小池子回答风格类记忆永远优先注入但总条数控制在6条以内。第三时间衰减要有度。老记忆不代表无价值。我采用的排序是最终得分余弦相似度0.7时间权重0.3这样即时是三个月前的事实只要相似度高依然能被检索到。不加时间权重的话新版记忆很容易被淹没在历史噪音里。3.4 关键参数选型与调优经验这里整理一下我在实际项目中用到的参数组合供参考。参数我的取值说明embedding模型text-embedding-3-small性价比高1536维对中文效果可接受向量库Chroma适合百万级以下规模检索方式余弦相似度先统一归一化再算点积top_k5-8根据prompt长度和任务类型动态调整相似度阈值0.3向量库内归一化前不同模型差异大需实测校准抽取频率每轮对话结束触发异步处理不阻塞主链路记忆最大条数/用户500条超过后按ref_count和recency淘汰关于embedding模型我再多说一句。对中文场景你完全可以用开源的BGE或者M3E模型效果并不差。选择text-embedding-3-small只是因为它API调用省心。如果你是在本地部署别把模型跑在CPU上embedding单条耗时虽然只有几十毫秒但并发量上来CPU就瞬间打满。我后来把embedding服务独立部署到一台小GPU机器上整个系统的P99延迟才恢复正常。提示无论是哪个embedding模型正式上线前至少要准备200个不同领域的真实查询测试一下相似度分数分布区间。同一个正值余弦0.5在某些模型里是高度相关在另一些模型里可能是完全不相关。不校准就设阈值的后面检索效果全凭运气。4. 实际运行中的问题排查与优化实录4.1 高频问题速查表我把记忆系统上线以来被问最多的问题整理成一张表方便直接对照。问题典型原因解决方案模型完全不“记得”用户召回阶段返回条数始终为0检查user_id过滤是否生效检查embedding维度一致性注入记忆后回答出幻觉top_k过大或阈值过低减少top_k提高阈值压缩记忆条目长度旧记忆覆盖新事实失败抽取层没有识别到同一实体的信息更新时间增加实体归一化步骤对同一主体做updated_at覆盖同一个记忆反复写入几百次抽取层没做语义级去重写入前做一次向量近重复检测相似度0.85则视为重复多用户间串数据召回时忘了带user_id过滤全局检查recall函数强制where条件为必填参数记忆库膨胀严重抽取粒度太细一点事就存一条合并同类记忆控制每类记忆的容量上限检索延迟突然飙升向量库全量扫描加索引类型为HNSW并把collection按用户分片其中“旧记忆覆盖新事实失败”是我最头疼的一个问题。用户上周说他“每天喝三杯咖啡”这周说“医生建议我别再喝咖啡了”。如果只做新增老的“每天喝三杯咖啡”依旧会被召回模型就会在同一个回答里给出自相矛盾的建议。我从抽取提示词入手要求模型遇到同一实体的新取值时必须输出{type: user_fact, content: ..., replace_target: 用户每天喝三杯咖啡}系统收到replace_target后在库里精确查找并做替换。4.2 三个印象深刻的踩坑记录第一个坑是embedding维度不一致。开发时我用的embedding模型输出1024维部署时切换到了另一个模型输出1536维结果库里已有数据向量长度和新查询向量长度不一致。Chroma报错还不太明显检索结果直接退化成随机排序。排查了半天才发现是模型版本不一致。这个问题的教训是embedding模型一旦确定就不要随便换实在要换必须全量重算向量没有捷径。第二个坑是相似度阈值的“幻觉”。我用了text-embedding-3-small之后用一套开发集评估发现相似度0.8以上的内容基本都是同义句0.5-0.8区间里混着大量表面相关但语义偏离的片段。当时把阈值定在0.6结果上线后用户反馈“AI忘性还是很大”。后来仔细分析了一批真实Query发现大量真实相关的对话在向量空间里相似度只有0.4出头因为口语化的表达方式跟书面陈述差太远。最终把阈值降到0.3召回率立刻上去噪声率也很低。第三个坑是同步链路的副作用。最早版本我把记忆抽取放在用户点击发送之后模型回答之后串行执行。用户平均响应时间从1.8秒涨到4.5秒。架构调整成异步化之后主路径不再等待抽取完成用户侧响应时间直接回到1.5秒。教训很简单凡是和用户主流程无关的耗时间操作一律丢后台队列。4.3 性能优化从百次到万次调用的压力应对不同阶段的性能瓶颈完全不同。初期几百次daily active用户的调用量Chroma单机完全能扛住瓶颈只在embedding这一环。当时embedding接口的并发上限是每分钟几千次完全够用。这个阶段别过早优化浪费时间。到了几千daily active用户时问题开始出现在检索层面。每次对话召回都需要做embedding向量检索LLM抽取如果没有缓存一次对话会产生3-5次外部API调用。我加了三个缓存手段第一查询向量结果按用户级缓存热点Query命中率大约30%第二记忆抽取只针对“有实质新信息”的对话触发通过关键词和消息长度做一个轻量预筛过滤掉70%无抽取价值的日常寒暄第三embedding结果本身做layer缓存相同句子直接取缓存向量。到了上万级调用我发现向量库的写入频繁导致检索毛刺原因是在线写入触发HNSW图的重建。后来把写入分成了两个阶段实时消息先写入消息表延迟5秒批量转换并写入向量库。既保证了写入吞吐又避免阻塞检索路径。5. 隐私、安全与产品化绕不开的边界5.1 记忆功能必须给用户“删除权”记忆功能的本质是把用户的私密信息长期化存储这本身就是一件需要谨慎对待的事。我上线的第一版因为只顾功能没想到用户会主动查看自己的记忆条目。结果有一个用户发现AI记住了他半年前提过的一个健康问题非常不满觉得“你们凭什么存这个”。后来我专门加了一个“记忆管理面板”用户能看到所有与自己关联的记忆条目支持逐条删除还有一键清空所有记忆的入口。这个功能带给用户的信任感远超预期。我的建议是做记忆功能的同时删除权要作为一等公民公民功能来设计不要等被用户投诉了再补。另外记忆库数据本身要做加密存储。向量库里的向量虽然不像明文那么直观但向量反推文本已经是研究领域验证过的问题不能掉以轻心。5.2 多租户数据隔离的硬性要求如果你做的是SaaS产品多个企业共用同一套系统user_id和tenant_id的隔离是必须验证的。我见过某团队上线后出现A企业的用户对话流到了B企业AI的上下文里事故级别足够直接下架的程度。我的做法存储在检索层强制校验每个涉及记忆的查询必须显式指定当前用户及所属租户不允许出现全局搜索接口。并且在召回结果的prompt组装里会额外加一行“如果上述记忆与当前用户无关请忽略”作为兜底逻辑。5.3 从记忆到知识管理后续的演进方向记忆功能稳定运行之后自然会长出两条演进路线。一条是记忆与外部知识库融合比如把用户的历史健康档案和医疗知识库结合做真正个性化的健康建议而不是靠模型“记住”某句话。另一条是用户主动配置的记忆也就是让用户直接告诉AI“我喜欢什么、不喜欢什么”由系统把这些主动声明设为最高优先级记忆覆盖掉模型自己从对话里推测的弱记忆。在技术架构上下一步可以加一个“记忆版本管理”。当用户改变偏好时不是简单地覆盖旧条目而是保留历史版本。在回答一些敏感问题时模型可以参考旧版本和变更时间给出“你在X月前曾提到A最近更新为B你要不要确认以哪个为准”的交互。这不会增加太多开发工作量但能极大增强用户对记忆功能的掌控感。个人经验补充如果你正在做自己的AI产品我的建议是牢牢掌握两个原则第一记忆系统一定要和主对话流程解耦不要为了让AI“记得”而拖慢用户的每一次交互第二宁可少抽取、多复盘也不要粗暴地把所有历史塞进向量库。我在实践中反复体会到记忆不是越多越好而是越精准越好。一次恰到好处的回忆比十次泛泛的参考更能让用户觉得这个AI“真的懂我”。后面你还会遇到记忆冲突、实体归一化、跨语言检索这些更细腻的问题每一步都有值得记录的教训。先跑通最小闭环别在第一天就想构建完美的记忆宇宙。
