故障排查GitHub Issue
解决FastGPT私有部署版知识库子目录PDF无法加载的问题
解决FastGPT私有部署版知识库子目录PDF无法加载的问题 现象 用户在FastGPT v4.8.11私有部署版本中，创建通用知识库并新建两层子目录，将PDF文件上传至第三层目录后，查看文件原始内容时提示"未能加载PDF文档"。在对话场景中关联该子目录下的PDF文件时，无法正常访问；但根目录下的同名PDF…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
解决FastGPT创建知识库上传文件后出现负载饱和报错问题
解决FastGPT创建知识库上传文件后出现负载饱和报错问题 现象 创建知识库并上传文件时，部分文件完成索引后出现流程卡滞。查看服务日志可见，POST /v1/embeddings接口返回429状态码，且存在报错信息：relay error (channel #5): 当前分组上游负载已饱和，请稍后再试，同时…
故障排查GitHub Issue
解决FastGPT调用对话接口提示Key错误的问题
解决FastGPT调用对话接口提示Key错误的问题 现象 调用FastGPT的/api/v1/chat/completions对话接口时，接口返回报错文本Key is error. You need to use the app key rather than the account key.，请求代码中通…
故障排查GitHub Issue
解决FastGPT知识库问答返回过时Windows自动登录设置的问题
解决FastGPT知识库问答返回过时Windows自动登录设置的问题 现象 用户在FastGPT中配置了包含Windows11最新自动登录完整步骤的知识库，当提问"Windows11 目前最新自动登录设置"时，系统返回的是未包含注册表修改步骤的失效旧配置方法，且多次测试结果未发生变化。 可能原因 FastG…
故障排查GitHub Issue
解决FastGPT知识库分块存储无法自定义分块长度的问题
解决FastGPT知识库分块存储无法自定义分块长度的问题 现象 在FastGPT 4.14.1私有部署版本的知识库功能中，用户处理文本数据集时选择分块存储模式，并设置自定义分隔符为两个换行符，但无法找到自定义分块长度的配置入口。实际的文本分割逻辑强制使用1000字符作为分块长度，导致分割后的文本内容碎片化严…
故障排查GitHub Issue
解决FastGPT知识库文件夹上传文件限制100个的问题
解决FastGPT知识库文件夹上传文件限制100个的问题 现象 在FastGPT V4.8.4私有部署docker版本中，使用知识库的文本数据集上传文件夹时，单次拖入的文件数量被限制为100个，相关界面截图显示单次上传文件数量上限为100。重启FastGPT所有组件后该限制会消失，重启前还会出现知识库训练卡…
故障排查GitHub Issue
解决FastGPT知识库最低相关度过滤不生效的问题
解决FastGPT知识库最低相关度过滤不生效的问题 现象 用户在私有部署V4.6.6版本的FastGPT中，于应用配置的知识库搜索参数里设置最低相关度为0.4，并开启了空搜索回复功能。在调试预览界面提问与知识库无关的问题时，系统未触发空搜索回复，反而返回了知识库引用内容。根据用户附带的截图，这些引用的相关性…
故障排查GitHub Issue
解决FastGPT使用知识库时模型调用路径异常报错问题
解决FastGPT使用知识库时模型调用路径异常报错问题 现象 用户使用FastGPT 4.8.1私有部署版本，配置了两台主机的模型，分别为chatglm和ollama，并通过oneapi完成模型配置。当模型配置列表中第一个模型为未启动的chatglm，第二个为ollama模型时，使用ollama模型且不调用…
故障排查GitHub Issue
排查并解决私有部署FastGPT知识库调用OneAPI报错的问题
排查并解决私有部署FastGPT知识库调用OneAPI报错的问题 现象 私有部署的FastGPT中，使用知识库功能触发报错。查看系统日志后，发现OneAPI返回报错信息，同时FastGPT侧存在对应调用失败的错误提示。 可能原因 结合部署环境与报错场景，可能的触发原因包括：FastGPT与OneAPI的网络…
故障排查GitHub Issue
FastGPT知识库上传训练后停滞及参数错误的排错方法
FastGPT知识库上传训练后停滞及参数错误的排错方法 现象 在FastGPT私有部署版本4.8.9的环境中，用户创建知识库并上传文件后，训练进度条无任何变化。系统日志提示prompt参数不正确，向量模型没找到，前端页面同步出现对应报错。用户已按照官方文档配置向量模型，且在渠道配置中也完成了向量模型的设置。…
故障排查GitHub Issue
解决FastGPT点击知识库时页面崩溃的排错方法
解决FastGPT点击知识库时页面崩溃的排错方法 现象 FastGPT流程可正常运行并回答问题，查看详情页的其他控件点击均正常，但点击知识库控件时页面立即崩溃。该问题跨版本存在，docker logs无错误日志，页面出现未捕获的异常，通过F12控制台可查看到Minified React error #300…
故障排查GitHub Issue
解决FastGPT知识库编号类关键词检索失败问题
解决FastGPT知识库编号类关键词检索失败问题 现象 用户导入包含编号/型号数据的知识库后，通过Q&A训练和文档上传操作，确保编号关键词被知识库内容多次覆盖。使用语义检索、全文检索功能时，均无法检索到对应编号的知识段落，相关检索结果截图显示未返回目标编号的知识内容，最终导致机器人回答与实际知识库内容不符，…