更新知识库前须确认三件事：一、知识库处于“未发布”状态；二、类型为文本或表格类；三、手动导出当前全部分片为csv备份。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
更新知识库内容前必须确认的三件事
当你需要在扣子平台更新客服话术、产品参数或政策文档时，不能直接覆盖原文件——旧版本内容一旦被新分片替换，就无法通过界面按钮一键还原。必须先确认知识库当前处于“未发布”状态，否则更新操作会触发实时重索引，导致正在服务的智能体短暂中断响应；检查知识库类型是否为文本或表格类，照片知识库不支持历史版本回溯；【务必在更新前手动导出当前全部分片内容为CSV备份】，因为扣子后台不提供自动版本快照功能。
文本/表格知识库内容更新操作
方法一：增量追加（推荐用于FAQ新增条目）
进入知识库管理页→点击「上传文件」→选择新增的TXT或Excel文件→勾选「追加到现有知识库」→提交后系统自动解析并合并分片，原有片段ID保持不变。
方法二：全量替换（适用于手册整体修订）
点击「编辑知识库」→在分段预览区顶部点击「清空所有分片」→确认弹窗中勾选「保留原始文件记录」→重新上传新版PDF/DOCX→设置分段规则（建议用标题作为分隔符）→点击「保存并重新索引」。这一步耗时较长，期间知识库处于不可用状态。
方法三：单片段修正（仅限已知错误段落）
在分段预览列表中找到目标片段→点击右侧铅笔图标→修改文本内容→点击「更新此分片」。注意：此操作不会改变该片段的向量嵌入值，若语义偏差大，需手动触发「重新计算向量」。
扣子 (Windows) 是字节跳动推出的一站式 AI Agent 平台客户端，支持多 Agent 协作、可视化工作流和知识库管理。最新版本新增 Claude Code 与 Codex CLI 接入、多端同步和项目级管理功能，同时优化了插件生态和 AI 响应速度，让用户在 Windows 上即可高效创建、运行和协作智能体，满足个人、团队及企业场景需求。
执行版本回滚的完整路径
第一步：定位目标历史版本
进入知识库详情页→下滑至「版本历史」区域→查看每条记录的「更新时间」「操作人」「变更摘要」→点击对应版本右侧的「查看详情」。
第二步：验证该版本可用性
在版本详情页中点击「测试检索」→输入3个典型用户问题→观察召回片段是否包含预期答案→若任一问题召回失败，说明该版本索引已损坏，跳过此版本。
第三步：执行回滚操作
返回版本历史列表→悬停在目标版本上→点击出现的「设为当前版本」按钮→系统弹出二次确认框→【勾选“强制重建全文索引”】→点击确认。整个过程约需2～8分钟，期间知识库不可用。
第四步：绑定回滚结果到工作流节点
打开关联的工作流编辑器→找到知识库检索节点→点击齿轮图标→在「知识库版本」下拉菜单中选择刚回滚的版本号→保存工作流→发布新版本。不执行此步，工作流仍将调用最新版知识库。
