故障排查GitHub Issue
解决FastGPT部署Ollama时的LLM模型响应为空报错
解决FastGPT部署Ollama时的LLM模型响应为空报错 现象 私有部署FastGPT 4.9.0版本，已确认使用的密钥可正常使用。本地部署OLLAMA并完成LLM、嵌入模型的配置且通过测试后，新建对话应用时出现chat:LLMModelResponseEmpty报错。 可能原因 当前版本不支持OLLA…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT结合Ollama的常见问题
解决FastGPT结合Ollama的常见问题 现象 使用FastGPT搭配Ollama部署的模型时，存在三类常见异常。第一类为引用知识库内容后回答未达预期，单独向模型询问问答与参考信息时结果正常。第二类为知识库中的图片无法在FastGPT输出中展示，使用其他方式加载模型时可正常展示图片。第三类为知识库检索异…
故障排查GitHub Issue
解决FastGPT无法正常使用需接入one api的问题
解决FastGPT无法正常使用需接入one api的问题 现象 使用FastGPT时无法实现预期功能，未明确具体报错文本，相关细节需按实际环境确认。 可能原因 未完成one api的接入配置，导致功能无法正常实现。 排查步骤 1. 确认当前使用的FastGPT部署类型。 2. 核对已配置的密钥是否可正常使用…
故障排查GitHub Issue
解决FastGPT配置ONEAPI后账户页填写密钥报错的相关问题
解决FastGPT配置ONEAPI后账户页填写密钥报错的相关问题 现象 配置ONEAPIURL与ONEAPIKEY后系统运行正常，但账户信息页面无法填写ONEAPIURL，页面返回报错：Incorrect API key provided: sk- D75e. You can find your API k…
故障排查GitHub Issue
解决FastGPT与OneAPI 0.6.8版本兼容运行时的报错问题
解决FastGPT与OneAPI 0.6.8版本兼容运行时的报错问题 现象 FastGPT 4.8.11-fix版本搭配OneAPI 0.6.8时，单独调试AI模块可正常输出内容，但运行完整流程时触发报错。将OneAPI降级至0.6.7版本后，报错问题消失。 可能原因 OneAPI 0.6.8版本与Fast…
故障排查GitHub Issue
FastGPT ONEAPI及OPENAI相关配置异常的排查与解决
FastGPT ONEAPI及OPENAI相关配置异常的排查与解决 现象 配置ONEAPIURL、ONEAPIKEY、OPENAIKEY、OPENAIBASEURL等环境变量后，模型调用无法正常完成，出现请求异常或认证失败的情况。 可能原因 1. 配置项冗余混淆，同时配置了多组认证相关参数，导致系统无法识别…
故障排查GitHub Issue
解决FastGPT中OneAPI访问MySQL连接被拒绝的问题
解决FastGPT中OneAPI访问MySQL连接被拒绝的问题 现象 OneAPI组件启动时输出报错信息：oneapi | [error] failed to initialize database, got error dial tcp 192.168.176.5:3306: connect: conne…
故障排查GitHub Issue
解决FastGPT与One-API容器间网络连接不通的问题
解决FastGPT与One-API容器间网络连接不通的问题 现象 在Docker环境中部署FastGPT与One-API后，无法正常建立服务连接。在容器内执行ping本地回环地址的操作正常，但跨容器连接仍无法正常工作。 可能原因 默认情况下，FastGPT与One-API容器会被分配到不同的Docker网络…
故障排查GitHub Issue
FastGPT 4.9.0 Ollama 空响应：历史流式兼容修复
FastGPT 4.9.0 Ollama 空响应：历史流式兼容修复 适用场景与历史记录 原报告指出升级 4.9.0 后模型渠道测试成功，聊天调用却返回空，embedding 调用正常。 原始讨论提交于 2025-03-07，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 维护者定位到当时基于 O…
故障排查GitHub Issue
FastGPT对接One API时提示词不生效的排查与解决
FastGPT对接One API时提示词不生效的排查与解决 现象 使用FastGPT对接One API时，部分场景下提示词未生效。知识库场景下提示词可正常生效，非知识库场景提示词未生效。同时存在部署One API的配置方式不明确的问题，用户无法快速完成对应配置。 可能原因 提示词未适配对接的目标模型；One…
故障排查GitHub Issue
解决FastGPT中OneAPI无法正常更新及更换的问题
解决FastGPT中OneAPI无法正常更新及更换的问题 现象 使用FastGPT过程中，部分用户感知到OneAPI无法正常更新，提出更换中转服务产品的需求；另有用户提出，向量模型归一化功能需由中转服务后台适配实现。 可能原因 官方计划替换现有中转服务，将新搭建的中转服务后台UI集成到FastGPT中；原服…
故障排查GitHub Issue
解决FastGPT中转OneAPI时stream=true无返回值的排查与修复方案
解决FastGPT中转OneAPI时stream=true无返回值的排查与修复方案 现象 使用FastGPT中转OneAPI时，请求参数携带stream=true时无返回值；请求参数stream=false时可正常响应。该场景下OneAPI无报错信息。直接调用容器原生接口且stream=true时可正常获取…