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

FastGPT集成第三方大模型平台相关问题排错指南

在FastGPT中尝试集成支持特定协议的第三方大模型平台时,出现无法正常发起智能会话、接口调用失败、token消耗异常或功能无法完成配置的情况。

现象

在FastGPT中尝试集成支持特定协议的第三方大模型平台时,出现无法正常发起智能会话、接口调用失败、token消耗异常或功能无法完成配置的情况。

可能原因

出现此类问题的可能原因包括:未正确配置第三方平台的接入密钥、接口地址等核心参数;未匹配第三方平台支持的协议规范进行对接;未确认平台的调用额度使用限制;FastGPT服务与第三方平台接口的网络连通性异常。

排查步骤(有序列表,每步可照做)

  1. 核对第三方平台提供的接入密钥、接口地址等核心配置参数,确保与FastGPT中的配置内容完全一致。
  2. 确认对接使用的协议类型与第三方平台支持的协议匹配,如Anthropic协议或OpenAI Completions协议。
  3. 检查第三方平台的调用额度使用情况,确认是否超出当日可用额度或付费额度限制。
  4. 需按实际环境确认FastGPT服务与第三方平台接口的网络连通性,确保可以正常发起请求。

解决与验证

针对排查出的问题,可按以下方式处理并验证:修正配置参数中的错误内容,重新保存配置后测试会话发起功能;调整协议对接方式,匹配第三方平台支持的协议规范;补充额度或等待额度重置后再次测试调用;验证会话生成结果、token消耗统计等功能是否正常运行,确认调用结果符合预期。

来源: FastGPT 官方来源

适用性与版本范围

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

安全护栏

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

回滚指引

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