解决FastGPT集合批量添加数据接口未返回QA ID的问题

现象

调用FastGPT集合批量添加数据接口时，接口返回结果未包含QA的ID。官方返回样例为：

{"code":200,"statusText":"","message":"","data":{"insertLen":1,"overToken":[],"repeat":[],"error":[]}}

可能原因

当前无明确已知触发原因，需按实际环境确认。

排查步骤

1. 查看接口返回的完整响应内容，确认data字段下是否缺失QA ID相关参数。
2. 核对接口调用参数与官方文档要求的一致性，官方文档链接为https://doc.fastgpt.in/docs/development/openapi/dataset/#%E4%B8%BA%E9%9B%86%E5%90%88%E6%89%B9%E9%87%8F%E6%B7%BB%E5%8A%A0%E6%B7%BB%E5%8A%A0%E6%95%B0%E6%8D%AE。
3. 检查导入数据的格式是否符合接口要求，确认无格式错误。

解决与验证

若确认接口未返回QA ID，可通过调用单条数据查询接口或集合数据列表接口获取已导入数据的QA ID。重新调用批量添加数据接口，验证返回结果是否包含预期的QA ID参数。

来源： FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 故障排查 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。