FastGPT 批量导入 FAQ:先用一份小 CSV 验证字段
FastGPT批量导入FAQ前,先从目标版本下载模板,用三条合成问答验证表头和处理结果,再导入正式资料。不能把网上找到的CSV直接当成所有版本通用格式。本文给出实际可下载的小CSV,并说明它适用于当前文档中的新模板体系,没有在真实FastGPT实例执行导入。
先核对版本再选表头
2026年10月23日核对的官方模板说明列出q、a、可重复的index与可选metadata。官方故障说明同时指出,4.9.11到4.15.8仅接受以q,a,indexes开头的CSV;4.16.0及以后支持新模板与XLSX,并兼容旧表头。因此本附件使用的q,a,index,metadata适合文档所述4.16+格式,旧部署应使用其界面提供的模板,不要强行改列名碰运气。
本次最小数据包括保修期限、耗材例外与服务时间三条FAQ。内容完全虚构,不能直接当成企业制度发布。每条问题和答案成对出现,自定义索引保留一个常见问法,元数据记录合成来源和版本。
下载后先检查文件本身
附件实际为UTF-8 CSV,第一行是模板表头,后面三行是演示记录。q与a不可同时为空;metadata填写有效JSON对象,不能写数组或普通备注。CSV里的JSON含双引号,需要按CSV规则成对转义,不能手工删掉引号让文件看起来更整齐。
用纯文本编辑器查看表头和行结构,再用表格软件检查是否串列。单元格包含逗号、换行或引号时,应由CSV工具正确保存。不要把文件扩展名从xlsx改成csv冒充转换,也不要在第一行前添加标题或说明文字。
如果使用表格软件另存,确认物料号、日期和前导零没有被自动改写。FAQ样本不包含敏感数据,但正式资料导入前仍应检查脱敏和来源权限。导入格式正确不代表内容可以合法公开给所有应用用户。
在目标库做一次小导入
记录FastGPT版本、目标知识库标识、使用模板和导入时刻。按目标界面选择模板导入,只上传这份小文件,等待数据处理完成。检查每条问答是否成为预期记录,索引和元数据是否被解析,而不是作为答案正文的一部分显示。
不要只看“上传成功”。逐条打开内容,核对中文、标点、答案换行与来源字段。三行源数据应能对应三条逻辑问答,实际向量条目可能因索引策略不同而更多,不能把向量数量直接当问答数量。
附件没有填导入结果,因为本文未实测。建议另建记录:源行号、目标集合、数据标识、实际q、实际a、处理状态和异常。若任何一条错位,先停在小样本排查,别继续导入几千条后再返工。
再做检索而非只看列表
分别用原问题和同义问法查询。保修题检查十二个月及标准整机限定;耗材题检查排除条件;服务时间题检查工作日条件。观察命中的是哪条数据、答案有没有把相邻FAQ混合,以及引用能否回到合成来源。
再问一条库里没有的未来政策,预期说明没有依据。小样本导入通过并不保证完整知识库效果,但能验证当前格式与基本链路。检索不准时要分开检查数据表达、索引和应用回答,不要直接改CSV表头。
常见失败分支
报模板格式错误,先核对版本和首行,特别注意旧版indexes与新版index差异。乱码则查看文件编码及导入文本,不要在没有证据时同时改编码、分隔符和平台配置。metadata解析失败,先用JSON解析工具校验该单元格,再查看CSV转义是否破坏了内容。
重复导入可能形成重复资料,平台是否自动去重要以目标版本实际行为为准。演示通过后,正式导入应建立外部来源编号与导入批次记录;更新同一FAQ时要明确是覆盖、替换还是新建,不能靠文件名相同推断自动更新。
扩大批量前的检查
先抽查不同长度、包含换行和带多种标点的记录,再确认导入失败如何回报、如何定位源行。业务方审核内容,技术方审核格式与处理状态,两者都完成后再扩大范围。
交付给接手人员时保留目标版本模板、三行样本、导入记录和检索题。下次平台升级先重跑小CSV,而不是拿整库做格式试验。一个可解释的小样本,比导入窗口显示成功更能说明数据确实按预期进入知识库。
正式资料还应先做内容去重和冲突检查。同一个问题若同时出现两个不同答案,需要业务负责人确认哪个生效,不能期待导入器自动选择正确版本。可以按标准问题、来源与适用范围建立内容清单,保留变更理由。三行演示通过后,再加一条包含逗号和换行的问答验证转义,加一条缺答案的普通内容验证目标模式。每次升级保存新旧模板副本与结果,避免未来接手人员依据记忆重建格式。
官方依据:模板导入给出新模板字段;通用问题排查的模板问题说明历史版本差异。官方文档入口经维护者仓库核对。
可下载本文合成样例与记录表,附件里的数据只用于演示核对方法,请在副本中填写目标环境结果。更多背景可看专题与相关原理及交付说明。需要把这套核对接进已有业务系统,可带上脱敏材料、当前版本与失败记录,通过定制咨询讨论范围;集成商可查看系统集成协作。