故障排查GitHub Issue
解决OceanBase部署FastGPT后知识库备份导入训练异常问题
解决OceanBase部署FastGPT后知识库备份导入训练异常问题 现象 使用OceanBase版本的docker-compose部署FastGPT v4.12.1私有部署版本后，执行知识库备份导入操作时出现训练异常。导入使用的CSV文件为官方模板，未做任何修改。 可能原因 当前公开信息未明确具体报错文本…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
FastGPT公有云版本偶发请求异常问题排查与解决指南
FastGPT公有云版本偶发请求异常问题排查与解决指南 现象 使用FastGPT公有云版本时，出现偶发请求异常问题，无法100%复现，预期请求可正常完成执行。 可能原因 现有信息有限，需结合实际运行环境排查，可能关联请求链路异常、临时服务波动等相关情况，具体原因需通过日志与场景分析确认。 排查步骤 1. 确…
故障排查GitHub Issue
解决FastGPT调用ollama时使用错误接口路径的问题
解决FastGPT调用ollama时使用错误接口路径的问题 现象 使用ollama私有部署环境时，通过curl命令可正常接收ollama的回复。但通过FastGPT应用示例或oneapi测试时，ollama日志显示实际调用的接口路径为"/api/chat"，未达到预期的"/v1/chat/completio…
故障排查GitHub Issue
FastGPT私有部署版上传文档无法解析问题排查指南
FastGPT私有部署版上传文档无法解析问题排查指南 现象 FastGPT 4.8.22私有部署版本中，使用ollama部署的qwen2.5-14b-1m模型时，上传的文档无法解析。调用官方API可正常识别文档。 可能原因 需按实际环境确认。 排查步骤 1. 确认FastGPT版本为4.8.22私有部署版。…
故障排查GitHub Issue
解决FastGPT使用Ollama嵌入模型得分超出0-1范围的问题
解决FastGPT使用Ollama嵌入模型得分超出0-1范围的问题 现象 使用FastGPT搭配Ollama的nomic-embed-text:v1.5嵌入模型执行语义检索时，检索结果的相似度得分超出0至1的正常范围，部分得分高于1，无法按照0-1的分数区间进行结果过滤。 可能原因 当前无明确已知关联原因，…
故障排查GitHub Issue
FastGPT集成ollama部署的m3e向量模型报错排查方法
FastGPT集成ollama部署的m3e向量模型报错排查方法 现象 用户在FastGPT中通过ollama部署聊天模型成功后，尝试集成m3e向量模型，使用one-api测试该向量模型时提示错误，未明确给出具体报错文本，同时附带了两张测试相关的截图，但截图未提供可识别的文字内容。 可能原因 目前仅能明确测试…
故障排查GitHub Issue
解决FastGPT 4.8.13版本调用Ollama模型上传图片报错的问题
解决FastGPT 4.8.13版本调用Ollama模型上传图片报错的问题 现象 私有部署FastGPT更新至4.8.13版本后，调用Ollama部署的minicpm-v视觉模型，执行上传图片并发起提问的操作时触发报错。该操作在4.8.12版本的私有部署环境中可正常执行，无异常报错。 可能原因 该问题为版本…
故障排查GitHub Issue
解决FastGPT无法兼容Ollama模型reasoning字段的问题
解决FastGPT无法兼容Ollama模型reasoning字段的问题 现象 本地使用Ollama部署qwen3:30b模型后，手动调用ollama的chat API，返回的JSON格式数据中，思考内容对应的字段名为"reasoning"。FastGPT在解析该思考字段时，仅识别"reasoningcont…
故障排查GitHub Issue
解决FastGPT私有部署中Ollama重排序模型测试404报错问题
解决FastGPT私有部署中Ollama重排序模型测试404报错问题 现象 私有部署版本V4.9.0的FastGPT中，通过Ollama添加本地重排序模型后，测试该模型时返回404 page not found报错。同一Ollama部署的语言模型、索引模型可正常完成测试和使用。 可能原因 具体原因需按实际环…
故障排查GitHub Issue
解决FastGPT文本提取工具中文显示Unicode编码问题
解决FastGPT文本提取工具中文显示Unicode编码问题 现象 在FastGPT私有部署版本v4.8.10 fix2中，使用ollama部署的llama3.1-8b-instruct模型时，调用文本内容提取工具，提取的中文内容有时会显示为Unicode编码格式。相关截图显示输出内容为类似\uXXXX的标…
故障排查GitHub Issue
解决FastGPT私有部署后OneAPI页面502无法访问问题
解决FastGPT私有部署后OneAPI页面502无法访问问题 现象 本次部署使用FastGPT私有部署V4.8.7版本，OneAPI版本为阿里云0.6.6。部署完成并按教程sleep 10秒后重启OneAPI，访问IP地址的3001端口无法进入OneAPI页面，请求长时间pending后返回502错误。同…
故障排查GitHub Issue
解决FastGPT私有部署4.8.22版OneAPI容器持续重启问题
解决FastGPT私有部署4.8.22版OneAPI容器持续重启问题 现象 使用docker-compose up -d命令启动FastGPT私有部署4.8.22版容器后，OneAPI容器持续处于Restarting状态，无法正常对外提供服务。 可能原因 暂未明确具体触发原因，需结合容器运行日志、配置文件等…