故障排查GitHub Issue
解决FastGPT私有部署断网后功能无法正常运行的问题
解决FastGPT私有部署断网后功能无法正常运行的问题 现象 使用Docker部署FastGPT并接入ChatGLM3，启动容器登录后功能正常。断开外部网络并在局域网运行时，创建应用、创建知识库等操作会卡在创建页面。重新连接外部网络后，所有功能恢复正常。 可能原因 未在当前issue线程中明确提及具体技术成…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT大规模数据场景下检索结果不准确问题
解决FastGPT大规模数据场景下检索结果不准确问题 现象 当数据量达到1万行时，混合检索无法检索到目标内容，导致回答不准确。少量数据场景下，回答结果准确，符合业务预期。 可能原因 向量检索对非语义内容效果不佳，无法精准匹配结构化的编号或无明确语义关联的文本；全文检索对编号类内容效果不足，难以定位特定目标数…
故障排查GitHub Issue
FastGPT配置限制仅回答知识库相关问题的操作方法
FastGPT配置限制仅回答知识库相关问题的操作方法 现象 部署使用FastGPT后，后台出现大量用户提问非知识库相关内容的记录，工具被当作通用聊天工具使用，无法限制仅返回与知识库关联的有效回答，导致资源被无效占用。 可能原因 未在对话提示词中添加明确的知识库内容限制规则，导致大模型无法识别需过滤的提问范围…
故障排查GitHub Issue
FastGPT中LLM工具调用不支持的排查与解决方法
FastGPT中LLM工具调用不支持的排查与解决方法 现象 使用FastGPT时，部分LLM的工具调用功能无法正常运行。 可能原因 未确认目标LLM是否支持工具调用功能，或未按照FastGPT官方文档完成工具调用的配置与测试。 排查步骤 1. 查阅对应LLM的官方文档，确认其是否支持工具调用功能。 2. 查…
故障排查GitHub Issue
FastGPT 本地部署新增账号的操作步骤
FastGPT 本地部署新增账号的操作步骤 现象 无法通过配置文件以外的途径新增FastGPT账号，本地部署场景下无法找到或打开注册入口以完成新用户注册。部分使用ghcr.io/c121914yu/fastgpt-admin:latest镜像的场景，会出现License验证相关异常，影响账号注册功能的正常使…
故障排查GitHub Issue
解决FastGPT修改本地百川分类模型后模块无效果的问题
解决FastGPT修改本地百川分类模型后模块无效果的问题 现象 在config.json文件中将分类模型修改为本地部署的百川模型后，问题分类模块无效果。 可能原因 由于仅获取到配置修改后模块无效果的现象，未获取到具体报错或配置细节，因此可能原因需按实际环境确认，常见关联方向包括配置项写入错误、本地模型服务异…
故障排查GitHub Issue
FastGPT连接本地数据库超时或连接失败的排错方案
FastGPT连接本地数据库超时或连接失败的排错方案 现象 使用FastGPT数据源配置插件连接本地数据库时，出现以下异常： 1. 当host参数填写为localhost时，返回空数据，但实际数据库存在对应数据，执行语句为SELECT FROM test WHERE stationid = 10003； 2…
故障排查GitHub Issue
解决FastGPT本地文件数据集导入的API调用异常问题
解决FastGPT本地文件数据集导入的API调用异常问题 现象 调用FastGPT本地文件数据集导入API时无法成功完成导入操作，已确认使用的密钥可正常使用。 可能原因 可能的原因包括API访问地址配置错误、请求头的授权信息格式错误、表单提交的data字段JSON格式有误、上传文件的本地路径不存在、数据集I…
故障排查GitHub Issue
解决FastGPT指定本地文件夹为知识库及更新的相关问题
解决FastGPT指定本地文件夹为知识库及更新的相关问题 现象 用户提出明确需求，希望直接指定本地文件夹作为FastGPT的知识库，且当本地文件夹内的文件发生修改时，知识库可自动更新或支持手动更新，经用户确认现有FastGPT版本无法满足该需求。 可能原因 当前FastGPT的官方功能未覆盖直接绑定本地文件…
故障排查GitHub Issue
本地部署FastGPT接入阿里FunASR的配置问题排错指南
本地部署FastGPT接入阿里FunASR的配置问题排错指南 现象 本地部署FastGPT后，尝试接入阿里FunASR语音服务时，配置相关参数后多次测试均不通过，无法正常完成服务接入，需明确config.json与OneAPI的正确配置方式。 可能原因 结合配置场景与测试失败的现象，可能的配置错误包括One…
故障排查GitHub Issue
解决FastGPT部署时本地模型接入与外网依赖问题
解决FastGPT部署时本地模型接入与外网依赖问题 现象 部署FastGPT过程中，需配置中转地址与密钥，无法实现完全私有化部署。用户希望使用本地开源大模型替代付费在线服务，且未在部署文档中找到本地模型的接入方法。 可能原因 部署文档未明确说明本地模型的接入方式，默认配置依赖中转服务导致需访问外网，且未提供…
故障排查GitHub Issue
解决FastGPT调用本地模型的Request timed out报错问题
解决FastGPT调用本地模型的Request timed out报错问题 现象 FastGPT 4.8.16版本调用本地模型时，因上下文较长、GPU资源有限导致等待时间较长，返回报错{"message": "Request timed out.", "name": "Error"}。直接调用目标模型API…