需定期清理火山引擎知识库中失效、冗余或过期文档，避免检索污染、召回偏差增大、RAG响应变慢及配额超限；VikingDB型知识库为向量存储、不可恢复删除，ArkClaw型保留源文件、支持删除或下线。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要定期清理火山引擎知识库中失效、冗余或过期的文档，避免检索结果污染、向量召回偏差增大、RAG响应变慢甚至触发配额超限告警。
确认知识库类型与文档存储位置
火山引擎当前支持两种知识库形态：基于VikingDB向量数据库构建的语义知识库，以及挂载在豆包智能体平台ArkClaw下的结构化文档知识库。前者文档以嵌入向量形式存在，原始文件不保留；后者仍保留PDF/Word/Markdown等源文件，可直接定位删除。
进入【火山方舟】控制台 → 左侧导航栏点击【知识库管理】→ 查看目标知识库卡片右上角标识：若显示“VikingDB”图标，说明为向量型知识库；若显示“ArkClaw”图标，则为源文件托管型知识库。二者删除逻辑完全不同，不可混淆操作。
删除ArkClaw知识库中的源文档
方法一：单文档删除（适用于少量确认过期的文件）
进入ArkClaw知识库详情页 → 点击【文档管理】标签页 → 在文档列表中勾选目标文件 → 点击顶部【删除】按钮 → 在弹窗中确认“将永久移除该文档及其所有索引” → 输入账号密码完成验证。
【注意：删除后该文档的向量化索引同步清除，但已加载到Agent运行时内存中的缓存可能残留1～3分钟，期间仍可能被召回。如需立即生效，需重启关联的智能体实例。】
方法二：按条件批量下线（推荐用于季度清理）
点击【高级筛选】→ 设置“最后更新时间”早于2025-01-01 → 勾选“仅显示已解析完成”状态 → 点击【批量操作】→ 选择【下线】而非【删除】→ 下线后文档保留在列表中但不再参与向量检索和RAG生成。
这一步不会释放存储空间，但能快速阻断过期内容参与推理，适合尚未完成合规审核前的临时隔离。
清理VikingDB知识库中的过期向量片段
第一步：登录VikingDB控制台 → 进入对应集群 → 选择目标数据库 → 点击【集合管理】
第二步：找到知识库对应集合（命名通常含kb_或profile_前缀）→ 点击右侧【数据浏览】
第三步：在查询栏输入过滤条件：{"metadata.source_id": {"$regex": "2024Q3|legacy_v1"} } → 执行查询，确认返回记录均为待清理旧数据
第四步：勾选全部结果 → 点击【批量删除】→ 系统提示“将物理删除所选文档及对应向量”，此时必须勾选【我已确认该操作不可逆】复选框 → 输入MFA动态验证码 → 点击【确认删除】
⚠️ 重要提醒：VikingDB不支持软删除或回收站机制。一旦执行，向量与元数据同时从磁盘抹除，且无法通过API恢复。务必提前用count_documents接口校验待删数量，避免误删整库。
