故障排查GitHub issue2 分钟阅读故障排查

FastGPT通过API接入外部工具后问答结果差异排查

FastGPT应用内直接对话、免登录分享链接的问答结果符合预期。通过API密钥接入外部工具后,得到的问答结果与应用内差异较大。用户存在两个疑问:一是外部工具发起的请求是否触发知识库搜索,二是如何查看外部工具的请求与响应对话历史。

现象

FastGPT应用内直接对话、免登录分享链接的问答结果符合预期。通过API密钥接入外部工具后,得到的问答结果与应用内差异较大。用户存在两个疑问:一是外部工具发起的请求是否触发知识库搜索,二是如何查看外部工具的请求与响应对话历史。

可能原因

可能存在API调用时未配置知识库检索参数、请求参数与FastGPT应用内设置不匹配,或未开启日志记录等情况,具体需按实际环境确认。

排查步骤

  1. 核对API调用的请求参数,确认是否包含FastGPT应用内配置的知识库检索相关设置;
  2. 开启FastGPT的API调用日志功能,获取外部工具发起的请求与响应数据;
  3. 对比应用内对话与API调用的参数、配置差异。

解决与验证

  1. 按照FastGPT应用内的对话配置,补全API调用所需的知识库检索等参数;
  2. 启用日志记录功能,查看外部工具的请求与响应内容,确认逻辑与应用内一致;
  3. 再次通过外部工具发起提问,验证问答结果是否与应用内相符。

来源: FastGPT 官方来源

适用性与版本范围

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

安全护栏

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

回滚指引

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