Docs
文档目录

记忆遗忘与数据保留

功能概述

记忆的价值会随时间和使用情况变化。Agentbase Memory 提供自适应衰减、到期处理和显式删除等机制,帮助管理长期积累的数据。正式调整策略前,请先在测试数据上预览,并按业务和合规要求确认保留、删除及恢复流程。

记忆遗忘处理:流程示意,不是运行截图

流程示意,不是运行截图;实际执行结果取决于项目配置及任务状态。

查看流程图大图

衰减与保留策略

系统根据记忆的创建或最近复习时间、类型及访问次数计算保留率;符合保护期和阈值条件的记忆可能被归档。到期处理与自适应归档是不同的判断,显式删除则由用户或应用主动发起。归档和物理清理的实际行为应结合项目配置与后台任务状态检查。

下表是 2.12.0 服务源码中的回退默认值;项目已有配置或流水线配置可能覆盖这些值,请以实际生效配置为准。

参数回退默认值说明
initial_retention1初始保留率
decay_rate1.5基础衰减参数
decay_rate_multipliersworking: 1、short_term: 7、long_term: 60按记忆类型调整衰减参数
reinforcement_factor0.3访问次数对衰减参数的影响
working_threshold / short_term_threshold / long_term_threshold0.3 / 0.6 / 0.8各类型阈值;配置须满足递增约束
review_intervals[1, 6, 24, 72, 168]复习间隔,单位为小时
review_adjustment_factor / review_interval_min_hours0.3 / 0.5复习调整因子及最小复习间隔(小时)
minimum_protection_hours168新记忆的默认保护期(小时)
permanent_forgetting_enabledfalse控制自适应归档时是否进入后台物理清理队列

这些参数并不保证每条记忆都会在某个固定时间被处理。若配置无效,应先修正配置;不要把策略默认值当作适合所有业务的推荐值。

在控制台预览遗忘策略

  1. 在目标项目进入 记忆 → 配置 → 遗忘 Pipeline,选择或创建可编辑的流水线草稿。

  2. 根据业务要求调整并保存草稿,然后在 运行样例 中填写测试用户 ID。

  3. 运行样例并检查各阶段结果。预览只读取当前用户有权访问的候选记忆,扫描数量受流水线的批次大小限制,因此不能将结果视为该用户全部记忆的完整清单。预览阶段不会执行业务记忆写入。

  4. 核对结果与影响范围后,再按界面提示发布;设为默认流水线是单独的选择,应确认后再操作。

该预览使用 POST /v1/memory/pipelines/{pipelineId}/validate,请求需要保存的 versionId 和包含 userId 的 data 对象,例如:

{
  "versionId": "DRAFT_VERSION_ID",
  "data": { "userId": "TEST_USER_ID" }
}

预览结果按 memory_scan、forgetting_decision 和 forgetting_operation 等阶段返回。候选动作可能包括 promote、review、archive 或 expire;没有动作的记录不一定逐条出现在决策列表中。接口需要 projects.write 和 memories.read 权限;普通项目 API Key 不提供 projects.write,请使用具备管理权限的 Console 会话。

删除与到期处理

记忆列表和 DELETE /v1/memory/memories/{memoryId} 支持显式删除;批量操作可参考记忆管理。保留策略、到期处理、显式删除与后台清理并非同一操作。删除前应核实影响范围,删除后结合任务与实际数据状态确认完成情况;不要将发起删除等同于所有底层数据已经立即物理擦除。

需要处理来源文件或下游画像、上下文时,也应分别检查这些资源的状态和相关业务要求。关于流水线配置和记忆操作,请参阅以下文档。

相关文档