模板导入 - Fastgpt

模板导入适合将已经整理好的内容或问答对批量写入知识库。FastGPT 支持导入 .csv 和 .xlsx 文件，并根据模板中的问题、答案、索引和元数据创建知识库数据。

文件结构

文件的第一行必须是表头。支持以下列：

表头	是否必需	数量	说明
`q`	是	1 列	内容或问题
`a`	是	1 列	答案；导入普通内容时可以留空
`index`	否	可重复	自定义索引，同一行可以填写多个索引
`metadata`	否	最多 1 列	JSON 对象，用于保存来源、分类等自定义信息

每一行代表一条知识库数据，q 和 a 不应同时为空。表头顺序不受限制，但不要使用模板之外的表头。

CSV 示例

csv

q,a,index,index,metadata
"FastGPT 是什么？","FastGPT 是一个 AI Agent 构建平台。","FastGPT 简介","AI Agent 平台","{""source"":""product-doc"",""category"":""overview""}"
"如何导入知识库数据？","可以使用 CSV 或 Excel 模板导入。","知识库导入","模板导入","{""source"":""help-center""}"

CSV 文件建议使用 UTF-8 编码。如果单元格中包含逗号、换行或双引号，需要按照 CSV 规则正确转义。

Excel 示例

Excel 文件使用与 CSV 相同的表头和数据结构：

q	a	index	index	metadata
FastGPT 是什么？	FastGPT 是一个 AI Agent 构建平台。	FastGPT 简介	AI Agent 平台	`{"source":"product-doc","category":"overview"}`
如何导入知识库数据？	可以使用 CSV 或 Excel 模板导入。	知识库导入	模板导入	`{"source":"help-center"}`

Excel 文件需要满足以下要求：

文件扩展名为 .xlsx，不支持 .xls
只能包含一个工作表
不能包含合并单元格
第一行必须是模板表头

导入步骤

打开目标知识库，在导入菜单中选择「模板导入」。
点击「下载 CSV 模板」获取示例文件，或者按照相同结构准备 .xlsx 文件。
填写数据并检查表头、单元格内容和文件格式。
选择文件并确认导入。每次只能导入一个文件。
导入完成后，在知识库集合中检查数据及训练状态。

元数据

metadata 用于为每条数据附加结构化信息。单元格内容应为有效的 JSON 对象，例如：

json

{ "source": "product-doc", "category": "overview", "version": 2 }

不要填写数组、纯文本或包含语法错误的 JSON。CSV 中的 JSON 需要按照 CSV 规则转义；Excel 单元格中可以直接填写 JSON 字符串。

文件格式异常

出现「文件格式异常」提示时，请依次检查：

文件是否为 .csv 或 .xlsx
表头是否包含且仅包含支持的列
q、a 是否各有一列，metadata 是否不超过一列
CSV 的引号、逗号和换行是否正确转义
Excel 是否只有一个工作表且没有合并单元格

建议先使用少量数据测试，确认格式正确后再分批导入大量数据。