forget

用户希望从 agentmemory 中删除数据：$ARGUMENTS

快速开始

memory_smart_search { "query": "old api key in config", "targetLayer": "memory", "limit": 20 }

显示匹配项，征得明确同意，然后：

memory_governance_delete { "memoryIds": "abc12345,def67890", "reason": "user privacy request" }

预期输出：

Found 2 matching memories. Confirmed. Deleted 2 memories.

原因

此操作具有破坏性且不可逆。准确显示将要删除的内容，并在调用 delete 前征得明确同意。按记忆 ID 删除，绝不要仅凭会话删除。

工作流

1. 使用 memory_smart_search 搜索，将用户的文本作为 query，设置 targetLayer: "memory"、limit: 20，并指定请求的项目／Agent 范围。 这些是按相关性筛选出的匹配项，并非完整清单。
2. 显示匹配项：记忆 ID、标题和范围。对机密值进行脱敏。征求明确确认。对沉默或含糊的“好吧，随便”不得继续操作。
3. 确认后，调用 memory_governance_delete，将 memoryIds 设为 逗号分隔的字符串，并可选提供 reason（默认值为 plugin skill request）。
4. 此操作不支持观察记录或整个会话的擦除。 继续操作前说明这一限制；绝不要将删除所选记忆说成是完整清除会话。不要传入观察记录 ID 或 sessionId。
5. 经验教训需单独处理：使用 memory_lesson_delete 和对应的 lessonId 删除单条；memory_governance_delete 不会删除经验教训。
6. 检查响应中的 deleted、notFound 和 failed。分别报告实际删除的内容和未解决的 ID。重试失败请求前，重新检查所选 ID；响应中断时，写入操作可能已完成，但结果未能返回。

反面示例

错误：搜索返回匹配项后，未显示匹配项或等待用户明确同意，就立即调用 memory_governance_delete。

正确：列出匹配项，询问“删除这 2 项？（是／否）”，仅在收到明确同意后删除。

检查清单

• 在执行任何删除操作前，已向用户显示匹配项。
• 已收到明确同意，而非自行假定。
• memoryIds 包含搜索结果中的真实 ID，绝不是单独的 sessionId。
• 最终消息说明了实际删除数量。

另请参阅

• remember：写入操作；forget 是它的撤销操作。
• recall：查找准确的记忆 ID 后再删除。

故障排除

如果 memory_smart_search 或 memory_governance_delete 不可用，请参阅 TROUBLESHOOTING.md。