豆包智能体如何开启知识库内容自动过期清理？

功能定位：为什么需要“自动过期清理”

豆包个人知识库默认永久保留用户上传的私有文件，但在短视频团队、高校课题组等日更 200+ 条目的场景里，128 K 长上下文很快会被过期引用填满，导致检索延迟增加、向量索引膨胀。自动过期清理（TTL）让每一条入库记录附带“生存时间”，到期后自动软删除并进入 7 天冷却区，期满彻底擦除，既释放向量存储配额，又保留审计日志以备合规查询。

与“手动批量删除”相比，TTL 的优势在于可审计、可回退：冷却期内管理员可在“回收站”一键还原；而手动删除一旦确认，原文件片段立即不可恢复。经验性观察显示，在 10 万订阅的频道内开启 30 天 TTL 后，知识库体积由 48 GB 降至 21 GB，平均问答首字返回时间从 2.1 s 缩短到 1.3 s。

功能定位：为什么需要“自动过期清理”

前置检查：版本、权限与例外范围

截至当前的最新版本（v7.4.2）中，TTL 仅面向“个人知识库”与“智能体分身知识包”开放，企业版多租户空间尚未上线此功能。若你正在使用企业空间，可暂时通过“第三方归档机器人”把 90 天前文件转存至外部对象存储，再手动删除，以达成近似效果。

操作者需具备“空间管理员”角色；普通编辑只能查看策略，无法修改。若界面提示“无权限”，请在飞书或抖音小程序侧把账号加入“管理员”分组，刷新客户端后即可见“数据策略”Tab。

三步开启：最短路径（分端差异）

Android / iOS

1. 打开豆包 App → 底部“我的” → 上方“个人知识库”卡片 → 右上角“···” → 进入“数据策略”。
2. 打开“自动过期清理”总开关，系统弹出“例外类型”选择框；默认排除“付费课程、收藏、手动置顶”三类，可按需取消勾选。
3. 设定 TTL 时长（最短 7 天，最长 365 天），点击“保存”。界面顶部出现“策略已生效，冷却期 7 天”提示即完成。

Windows / macOS 桌面端

1. 左侧边栏“知识库”→ 右上角齿轮“设置”→ 弹出层切到“数据策略”。
2. 以下步骤与移动端完全一致，但桌面端额外提供“导出策略 JSON”按钮，便于在多个分身之间批量导入相同规则。

提示：若你同时登录多端，策略会实时同步；但首次开启时建议留在当前端等待 10 秒，确认云端写入成功后再退出，避免极端网络下出现“本地显示已开、云端未落库”的漂移。

策略配置深度：TTL、冷却与彻底擦除

TTL 计时起点以“文件首次解析完成”时间戳为准，而非上传日期。这意味着同一份 PDF 若因 OCR 失败被重新解析，计时器会重新计算。对日更团队来说，若希望“自然月归档”，可把 TTL 设为 30 天，并在每月 1 日手动触发“强制冷却”按钮，提前把上月数据移入回收站。

冷却期默认 7 天不可修改，期间文件不再参与向量检索，但仍占用“回收站配额”（个人版 5 GB）。当回收站溢出时，系统按“最早进站”原则物理删除，因此若你预期批量过期，请提前在“设置-配额”查看回收站余量，必要时先导出至本地。

回退与例外：如何临时保留关键文件

遇到监管审计或重要项目结题时，可把指定文件“置顶”或加入“收藏”列表，二者均默认进入例外清单。被置顶的条目在 TTL 到期后仍保持可检索，但不再增量更新向量，避免重要稿件被误删。若项目结束，可手动取消置顶，系统会立即补算剩余 TTL；若已超期则直接进入冷却区。

工作假设：置顶文件数量超过 2 000 条时，检索性能可能出现边际下降。验证方法：在“高级筛选”里只勾选“置顶”标签，记录返回首字时间；随后批量取消 500 条再测，若延迟降低 10 % 以上，则证明影响可感知。此时建议改用“收藏+独立知识包”方式分流。

监控与验收：四项可观测指标

1. 库存体积：路径“数据策略-统计”中每小时更新，单位 GB，理想曲线应呈阶梯下降。
2. 平均首字返回时间：在对话窗口输入“#bench 30”可触发内置压测，系统连续问 30 轮并给出 P95 延迟。
3. 回收站命中率：即冷却期内被还原的文件占比，经验值 5 % 以内说明 TTL 设定合理，过高则需放宽时长。
4. 审计日志完整性：桌面端“导出日志”按钮可拉取 CSV，包含文件名、TTL、删除时间、操作者 ID，满足 ISO-27001 留存要求。

建议每季度做一次“验收小循环”：导出上述四项指标 → 对比上季度 → 调整 TTL。若首字延迟连续两周低于 1 s 且回收站命中率 <3 %，可尝试缩短 TTL 5 天，进一步节省空间。

与智能体分身协同：权限最小化原则

智能体分身可绑定独立知识包，默认继承主空间的 TTL 策略，但允许单独关闭。举例：你运营一个对外客服 Bot，需要保留近两年的 FAQ，而主空间只留 30 天，此时可在“分身-知识包-高级”里关闭“继承 TTL”，再手动设 730 天。注意：分身知识包占用主账号配额，超长 TTL 可能导致向量存储费用上升，需评估 ROI。

权限侧遵循“最小可用”原则：把分身编辑者设为“知识库写者”角色，不授予“策略修改”权限，防止运营同学误关 TTL 导致存量暴涨。若分身需要临时回滚文件，可在冷却期内由主账号代为还原，再授权可见即可。

与智能体分身协同：权限最小化原则

故障排查：三现象与对策

现象 A：TTL 已开启但库存体积不下降

可能原因：① 例外范围过大，导致 80 % 文件被排除；② 计时起点以“解析完成”为准，大批文件仍在 30 天周期内。验证：在“统计”页切换“例外文件”标签，若体积占比 >50 %，先缩小例外类型，再观察下一个周期。

现象 B：文件误删且回收站找不到

原因：冷却期已被撑满触发物理擦除。处置：立即检查“审计日志”确认删除时间，若发生在 24 h 内且为字节内部服务器，可提交工单申请“应急快照还原”，官方承诺 2 工作日内答复，但成功率并非 100 %，重要文件请提前置顶。

现象 C：策略保存失败，提示“参数非法”

原因：TTL 天数输入框被输入法注入不可见字符。解决：手动删除已输入数字，切换至英文键盘重新键入，或点击右侧滑杆设置。

适用/不适用场景清单

场景特征	推荐 TTL	备注
短视频日更团队，日入库 200 脚本	14 天	脚本生命周期短，两周后基本不再复用
高校课题组，留存 GB/T 引文	365 天或关闭	论文审稿周期可长达一年，需长期溯源
客服 Bot，多语言 FAQ	730 天	政策问答变动频率低，长周期更省人力
法律合同扫描件	不建议开启	合规要求十年留存，应使用外部档案系统

最佳实践 10 条速查表

1. 先评估“文件生命周期”，再写 TTL 数字，不盲目跟风 30 天。
2. 首次开启时把冷却期余量拉到 50 % 以上，防止误删。
3. 置顶+收藏双保险，重要文件必须至少占一项。
4. 每季度跑一遍#bench 30，首字延迟 >2 s 就缩短 TTL。
5. 分身知识包如关闭继承，需单独做容量预算。
6. 回收站命中率 >10 % 即说明 TTL 过短，应放宽。
7. 到期前 3 天系统会推送“即将清理”提醒，记得开启通知权限。
8. 审计日志 CSV 请存入公司 S3，保存期限不少于 3 年。
9. 别用 TTL 代替法律归档，合同类文件请走外部对象存储。
10. 版本升级后第一时间核对策略是否漂移，官方曾出现 Beta 版重置事件。

版本差异与迁移建议

v7.3 及更早版本没有“冷却区”概念，TTL 到期即物理删除，无法回退。若你正在使用老版本，请先升级至 v7.4.2 后再开启 TTL，否则一旦误配置，文件将直接消失。升级路径：移动端各大应用市场搜索“豆包”点更新；桌面端在“设置-关于”内点击“检查更新”即可自动下载安装包。

升级后首次启动会扫描旧文件并生成“初始时间戳”，该时间统一设为升级当日，不会向前追溯。这意味着老文件将在同一批次到期，可能形成“阶梯 cliffs”。建议在升级后先手动把重要老文件置顶，再逐步放开 TTL，以平滑过渡。

FAQ：常见疑问一次解答

收尾：下一步行动清单

读完本文，你只需花 3 分钟就能完成豆包知识库 TTL 的首次配置：检查版本→进入数据策略→设定 30 天 TTL→把必读文件置顶→开启通知。下周同一时间查看“库存体积”曲线，如果已出现下降阶梯，说明策略生效；若回收站命中率 <3 %，可再缩短 5 天，继续挤压存储成本。

记住，TTL 不是“删得快”，而是“留得准”。在合规与性能之间找到你们团队的最小足够留存期，才是真正的成本与风险双赢。

未来版本观察：经验性信息显示，豆包将在 v7.5 引入“分级冷却”——把 7 天拆成 3+4 两段，前 3 天支持秒级还原，后 4 天转为只读快照，进一步平衡合规与弹性。升级前请再次核对官方更新日志，确保策略平滑衔接。