SuperAPI AI 工具集

cognee-forget

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

用途:当用户表达“忘掉……”“从记忆中删除……”“不要再记得……”时,用 cognee-forget 从 Cognee 记忆里删除对应文档。它不适合清空整个数据集或全部记忆,除非用户明确要求。

主要能力:删除文档会移除其原始数据、派生的图知识,并尽力清除受其污染的会话记忆(引用了被删图元素的问答轮次,以及由此产生的反馈和提炼指引)。这是定向删除而非整段会话清除:仅讨论过该主题但未引用被删元素的轮次会保留,agent 追踪条目不会被匹配。文档删除才使遗忘持久,确认时不要承诺会话缓存已完全不含该主题。

使用方式:全部服务器访问经由 cognee-forget.sh 助手,它按与其他技能相同方式解析基础 URL 和 API 密钥(shell 环境 → ~/.cognee/.env → api_key.json 中自动生成的本地密钥)并始终发送 X-Api-Key,云与本地模式均如此,因为服务器即使在 localhost 也强制认证。不要用原始 curl 绕过:本地模式下密钥不会导出到 shell,原始请求会返回 401。每个助手命令都会打印 JSON 响应和最后的 HTTP 状态行,务必检查。底层端点见 $COGNEE_BASE_URL/docs(本地 http://localhost:8011/docs)。

步骤:先运行 cognee-forget.sh sync 同步实时会话;再用 datasets 找到当前数据集($COGNEE_PLUGIN_DATASET,否则 agent_sessions)的 UUID;用 data <dataset_id> 列出数据,可先用 cognee-search.sh 缩小范围;用 raw <dataset_id> <data_id> 读取候选文档原始内容,按语义而非仅关键词判断,并按会话分组(同一会话的多个文档通常承载相同内容,需一并处理)。确认后对每个匹配 data id 运行 forget <dataset_id> <data_id>,出现 HTTP 2xx 即表示该文档及其派生知识已删除。最后如实报告删除与保留情况,未匹配就不要删除“最接近”的文档。

限制:删除不可逆,删除前应展示匹配清单并取得确认。已注入当前对话上下文的内容在对话结束前仍可见;会话缓存中的工具调用追踪条目不会因文档删除而失效,本会话若捕获过该主题追踪,后续同步可能重新持久化为新追踪文档,需要再次遗忘。助手仅支持单文档删除;更广范围需在用户明确要求并确认后,用助手 env 命令解析凭据并在同一次 shell 调用中直接调用 /api/v1/forget 端点({datasetId} 删整个数据集、{datasetId, memoryOnly:true} 仅清记忆、{everything:true} 删全部用户数据)。错误处理:退出码 2 表示未解析到密钥;401 表示密钥被拒;404 表示数据已删除,可继续;{"error": ...} 表示服务器可达但请求失败,应如实反馈而非认为已删除。