记忆遗忘与数据保留
功能概述
记忆的价值会随时间和使用情况变化。Agentbase Memory 提供自适应衰减、到期处理和显式删除等机制,帮助管理长期积累的数据。正式调整策略前,请先在测试数据上预览,并按业务和合规要求确认保留、删除及恢复流程。
流程示意,不是运行截图;实际执行结果取决于项目配置及任务状态。
衰减与保留策略
系统根据记忆的创建或最近复习时间、类型及访问次数计算保留率;符合保护期和阈值条件的记忆可能被归档。到期处理与自适应归档是不同的判断,显式删除则由用户或应用主动发起。归档和物理清理的实际行为应结合项目配置与后台任务状态检查。
下表是 2.12.0 服务源码中的回退默认值;项目已有配置或流水线配置可能覆盖这些值,请以实际生效配置为准。
| 参数 | 回退默认值 | 说明 |
|---|---|---|
initial_retention | 1 | 初始保留率 |
decay_rate | 1.5 | 基础衰减参数 |
decay_rate_multipliers | working: 1、short_term: 7、long_term: 60 | 按记忆类型调整衰减参数 |
reinforcement_factor | 0.3 | 访问次数对衰减参数的影响 |
working_threshold / short_term_threshold / long_term_threshold | 0.3 / 0.6 / 0.8 | 各类型阈值;配置须满足递增约束 |
review_intervals | [1, 6, 24, 72, 168] | 复习间隔,单位为小时 |
review_adjustment_factor / review_interval_min_hours | 0.3 / 0.5 | 复习调整因子及最小复习间隔(小时) |
minimum_protection_hours | 168 | 新记忆的默认保护期(小时) |
permanent_forgetting_enabled | false | 控制自适应归档时是否进入后台物理清理队列 |
这些参数并不保证每条记忆都会在某个固定时间被处理。若配置无效,应先修正配置;不要把策略默认值当作适合所有业务的推荐值。
在控制台预览遗忘策略
在目标项目进入 记忆 → 配置 → 遗忘 Pipeline,选择或创建可编辑的流水线草稿。
根据业务要求调整并保存草稿,然后在 运行样例 中填写测试用户 ID。
运行样例并检查各阶段结果。预览只读取当前用户有权访问的候选记忆,扫描数量受流水线的批次大小限制,因此不能将结果视为该用户全部记忆的完整清单。预览阶段不会执行业务记忆写入。
核对结果与影响范围后,再按界面提示发布;设为默认流水线是单独的选择,应确认后再操作。
该预览使用 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} 支持显式删除;批量操作可参考记忆管理。保留策略、到期处理、显式删除与后台清理并非同一操作。删除前应核实影响范围,删除后结合任务与实际数据状态确认完成情况;不要将发起删除等同于所有底层数据已经立即物理擦除。
需要处理来源文件或下游画像、上下文时,也应分别检查这些资源的状态和相关业务要求。关于流水线配置和记忆操作,请参阅以下文档。
