记忆新鲜度衰减

更新时间:
复制 MD 格式

记忆新鲜度衰减用于让搜索结果更符合“近因优先”的直觉:最近被用到的记忆排得更前,长期无人问津的记忆排得更靠后。它帮助 Agent 在用户偏好、状态随时间变化时,始终优先拿到最新的有效信息。

解决的问题

在未使用新鲜度衰减时,搜索结果排序可能出现以下问题:

  • 用户偏好已经改变,但旧记忆与查询同样相关,排序不稳定,Agent 时而拿到过时信息。

  • 记忆库使用越久,陈旧内容越多,搜索结果被历史信息稀释。

  • 近期信息与陈旧信息在排序上没有差别,不符合业务对“当前状态优先”的预期。

主要能力

能力

说明

近期优先

最近被搜索用到的记忆在结果中排位上升,Agent 更容易拿到当前有效的信息。

陈旧降权

长期没有被用到的记忆排位下降,但仍有机会被召回,不会凭空消失。

零改造接入

开启后搜索接口不需要任何改动,效果自动生效。

随时开关

关闭后排序立即回到原有方式,不产生任何残留影响。

越用越准

系统持续记录记忆的使用情况,开启即有数据可用,无需预热。

适用场景

  • 用户画像随时间演变的场景:饮食偏好、出行习惯、设备设置、沟通风格等。

  • 状态类记忆为主的助手:车机、智能家居、个人助理,需要优先反映用户当前状态。

  • 记忆库长期使用后,希望搜索结果自然地向近期信息倾斜。

说明

不适合的场景:记忆以长期有效的事实为主(如档案、知识库),且很少被重复召回——这类记忆开启后排位可能下降,需评估。

效果验证

通过一个贴近真实使用的评测验证了新鲜度衰减的效果:模拟一位用户与个人助手持续交互 30 天,期间生活状态、偏好、活动不断变化,助手需要始终返回最新的、当前有效的信息。

核心结果:开启新鲜度衰减后,近期偏好变更问题的回答准确率提升 13.1%。

问题类型

未开启

开启后

提升

偏好变更(“我现在喜欢什么”)

57.5%

76.8%

+19.3%

如何使用

操作

接口

说明

开启/关闭衰减

POST /configure

配置持久化,重启不丢失,默认关闭。

查看开关状态

GET /config

返回当前实例配置。

查看记忆使用情况

GET /memories/{memory_id}/stats

查看单条记忆的最近使用时间,用于理解其排位。

开启衰减:

curl -sS -X POST "${MEMORY_URL}/configure" \
  -H "Authorization: Token ${MEMORY_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"enable_recency_decay": true}'

查看当前开关状态:

curl -sS "${MEMORY_URL}/config" \
  -H "Authorization: Token ${MEMORY_API_KEY}"

查看某条记忆的使用情况(memory_id 可从记忆列表或搜索结果中获得):

curl -sS "${MEMORY_URL}/memories/${MEMORY_ID}/stats" \
  -H "Authorization: Token ${MEMORY_API_KEY}"

返回示例:

{"memory_id": "xxxxxxxx", "access_count": 12, "last_accessed_at": "2026-08-15T10:30:00+08:00"}

其中,access_count 是该记忆被搜索召回的累计次数,last_accessed_at 是最近一次被用到的时间——两者共同决定它当前的新鲜度排位。

说明

开启后,所有搜索自动应用新鲜度排序,无需修改搜索调用。衰减只调整排序、不过滤结果:任何记忆都不会因为衰减而从结果中消失,只是排位变化。

使用建议

  • 偏好、状态类场景优先开启:用户画像随时间演变的应用收益最明显。

  • 长期事实为主的场景谨慎开启:很少被召回的档案类记忆排位会下降,先小范围验证。

  • 衰减不是删除:它只改变排序,不删除任何记忆;需要让记忆彻底退出搜索请使用记忆遗忘。

  • 在自己业务上观察效果:开启后用同一批典型查询对比 top 结果,或通过 GET /memories/{memory_id}/stats 查看单条记忆的使用情况,理解其排位原因。

  • 与记忆遗忘配合使用:衰减让近期信息排前,遗忘让长期闲置信息退出,两者组合可以让记忆库既有序又精干。