杭州，2026 年 10 月 19 日 —— “怎么把知识处理成问答对”“问答对是什么格式”在社群提问中反复出现。客服、制度咨询、产品答疑这类场景，很多团队手里已经有现成的问答清单，也有大量需要先拆成问答的长文档。FastGPT 依据 v4.17.2 官方文档，梳理知识库中问答对的数据形态、三种写入方式与检索时的注意事项。

行业背景

企业整理知识时常见两种素材。一种是已经成形的问答，例如客服话术、常见问题清单、制度解释，问题与答案一一对应；另一种是长篇的制度文件、产品手册与技术说明，信息完整，但不直接对应用户的问法。前者直接入库就能使用，后者需要决定是按段落分块，还是先拆成问答。很多团队在这一步凭经验处理，结果同一个知识库里混着长短差异很大的数据，检索结果忽多忽少，回答质量也难以复盘。

问答对的数据形态与三种写入方式

在 FastGPT 知识库中，一条数据由 q（主要数据）与 a（辅助数据）组成，并带有用于检索的索引。按 OpenAPI 文档，q 必填、a 选填；每组数据的自定义索引最多 5 个，索引类型包括默认索引、自定义索引、总结索引、问题索引与图片索引，不传自定义索引时，系统会基于 q 和 a 组成一个默认索引。用于问答时，q 放问题，a 放答案，再用自定义索引补充同一问题的其他问法。

第一种写入方式是模板导入，适合已经整理好的问答清单。在知识库的导入菜单中选择“模板导入”，下载 CSV 模板，或按相同结构准备 .xlsx 文件。文件第一行必须是表头，支持 q（内容或问题，必需）、a（答案，导入普通内容时可以留空）、index（自定义索引，可以重复多列）与 metadata（最多 1 列，填写 JSON 对象，用于保存来源、分类等信息）；q 和 a 不应同时为空，表头顺序不限，但不要使用模板之外的表头。CSV 建议使用 UTF-8 编码，Excel 文件不支持 .xls，只能包含一个工作表且不能有合并单元格，每次只能导入一个文件。

第二种是问答拆分，适合需要先拆成问答的长文档。知识库常见问题说明，“文件处理模型”用于数据处理中的增强处理与问答拆分，在问答拆分中执行问答对生成；通过接口创建集合时，对应的 trainingType 取 qa，按文本长度分割则取 chunk。文档给出的 qa 模式 chunkSize 建议范围是 4000 到模型最大 token，16k 模型通常建议不超过 10000。默认的拆分提示词会要求模型从一段文本中提出最多 25 个问题并给出答案。

第三种是通过 OpenAPI 推送数据到训练队列，适合由业务系统定期同步的问答。调用 pushData 接口，传入集合 ID、训练模式与 data 数组，每组数据含 q、a 与可选的 indexes，每次最多推送 200 组，返回结果中的 insertLen 为最终插入成功的数量。

检索时要注意的几处

问答对入库后与普通分块一起参与检索。引用上限按 tokens 控制，文档解释了这样设计的原因：问答库与文档库混合时，不同数据的长度差距很大，按条数取结果会不稳定。检索方式上，语义检索适合自然语言问题，全文检索适合编号、型号、专有名词等精确查询，混合检索同时使用两者，并通过 RRF 合并结果。导入完成后，可以用知识库的搜索测试核对效果，也可以调用 OpenAPI 的搜索测试接口，传入检索文本、最大 tokens 数量、最低相关度、搜索模式与是否重排，查看返回的每条数据及其 q、a 内容，确认用户常用的几种问法都能命中对应的问答。

几处边界需要提前确认。问答拆分依赖文件处理模型的能力，生成的问答需要人工抽查，原文没有写清的内容不会因为拆成问答而变得清楚。模板导入对格式要求严格，出现“文件格式异常”时应先检查表头、列数、转义与工作表数量，文档建议先用少量数据测试，确认格式后再分批导入。问答清单还需要随制度与产品变化更新，过期的答案会被同样检索出来。应用评测在官方版本对比表中为商业版与云服务版功能，用问答对评估应用效果时需要先确认版本。

可直接核对的验收要点

1. 已整理好的问答清单是否按模板表头导入，q 和 a 是否没有同时为空？

2. 需要拆成问答的长文档，是否抽查过问答拆分生成的结果？

3. 同一问题的不同问法，是否用自定义索引补充，且每组不超过 5 个？

4. 由业务系统同步的问答，每次推送是否控制在 200 组以内，并核对了 insertLen？

5. 问答清单的维护人与更新周期是否已经明确？

关于 FastGPT

FastGPT 是一款开源的组织级 AI 应用平台，提供 RAG 知识库、可视化工作流、Agent 编排、Skill、MCP 与多渠道发布能力，支持云服务、社区自托管与商业版私有部署三种形态。支持企业微信、微信公众号、个人微信、飞书、钉钉与网页嵌入等发布方式，具体能力以版本与配置为准。截至 2026 年 10 月 19 日，GitHub 仓库 labring/FastGPT 有 29,856 个 Star、7,337 次 Fork，累计 278 个 Release，最新版本为 2026年10月9日 发布的 v4.17.2。项目开源仓库地址为 github.com/labring/FastGPT。

资料来源：知识库问答对的组织与导入的功能与参数依据 FastGPT v4.17.2 官方文档；仓库数据为 2026-10-19 查询快照。官方文档源码（https://github.com/labring/FastGPT/tree/v4.17.2/document/content）；发行记录（https://github.com/labring/FastGPT/releases/tag/v4.17.2）。