故障排查GitHub Issue
记录并提取FastGPT无法回答的对话数据的方法
记录并提取FastGPT无法回答的对话数据的方法 现象 当用户提出的问题在知识库中无相关知识时，系统按照预设提示词拒绝回答。需将此类无法回答的问题全部记录，后续由人工编写答案并手动插入知识库以完善知识库。 可能原因 此类无法回答的对话数据未单独归集存储，分散在MongoDB数据库的相关数据表中，需通过检索数…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
处理FastGPT功能请求提交时功能描述等内容缺失的问题
处理FastGPT功能请求提交时功能描述等内容缺失的问题 现象 提交FastGPT的功能请求时，仅完成例行检查的全部勾选，包括确认无类似功能、已升级到最新版本、已查看项目README、愿意跟进协助测试、认可维护规则，但未填写功能描述、应用场景及相关示例的具体内容。 可能原因 提交功能请求时，未按照项目要求补…
故障排查GitHub Issue
解决FastGPT创建文件集合返回HTML无法响应的问题
解决FastGPT创建文件集合返回HTML无法响应的问题 现象 部署FastGPT后，尝试创建文件集合时始终返回HTML格式内容，无法正常响应，其他API功能均正常。 可能原因 该问题与FastGPT v4.8版本相关，创建文件集合功能为4.8.1-alpha版本新增特性，旧版本存在该接口返回HTML的异常…
故障排查GitHub Issue
FastGPT上传文件超出模型上下文长度的流程优化方案
FastGPT上传文件超出模型上下文长度的流程优化方案 现象 上传文件至FastGPT后，经解析的总文本长度超出所绑定大模型的上下文窗口限制，无法直接将完整文件内容传入大模型生成回答，导致问答流程异常。 可能原因 上传的文件经解析转换为文本后，总长度超过了当前使用大模型的上下文窗口上限，大模型无法处理超出限…
故障排查GitHub Issue
FastGPT PDF 增强解析多模型选择：历史需求与自定义接口
FastGPT PDF 增强解析多模型选择：历史需求与自定义接口 适用场景与历史记录 原议题请求针对表格、印章等场景选择不同 OCR 服务，并建议遵循自定义解析接口。 原始讨论提交于 2025-08-29，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 当前官方环境变量文档提供自定义 PDF 解…
故障排查GitHub Issue
解决FastGPT文件粘贴与拖入上传的操作问题
解决FastGPT文件粘贴与拖入上传的操作问题 现象 用户反馈FastGPT现有文件上传流程需点击按钮选择文件，步骤较多，体验不佳。部分用户在版本4.8.12中尝试粘贴图片上传未成功，且未支持文件拖入上传功能，希望优化为粘贴或拖入即可上传的方式。 可能原因 1. 未激活聊天输入框，导致粘贴操作无法被识别为上…
故障排查GitHub Issue
解决FastGPT文件导入生成问答对的数量与质量问题
解决FastGPT文件导入生成问答对的数量与质量问题 现象 使用FastGPT导入文本文件时，系统自动生成25个问答对并直接生成索引。存在两类问题：导入的文本过短时，生成的25个问答对数量冗余；导入的文本过长时，25个问答对数量不足。生成的问答对准确性无法保证，且无法直接进行确认、修改或重新生成。 可能原因…
故障排查GitHub Issue
解决FastGPT文件分段无来源标识导致知识库匹配结果混乱问题
解决FastGPT文件分段无来源标识导致知识库匹配结果混乱问题 现象 文件直接分段处理后生成的内容碎片无法区分来源，会导致同一类知识的不同场景内容混合。例如同一知识主题下，不同地区的规定内容无法被区分，知识库匹配时会出现跨来源内容混淆，最终导致回答结果混乱。 可能原因 文件分段处理过程未自动添加内容来源标识…
故障排查GitHub Issue
FastGPT对话上传文件图片的存储位置与管理方法
FastGPT对话上传文件图片的存储位置与管理方法 现象 用户关注FastGPT对话过程中上传的图片与文件的存储位置，询问除对话日志外统一查看这些文件内容的途径，同时提出当积累大量文件与图片时，如何进行统一管理与清理。 可能原因 未明确FastGPT上传文件、图片的存储载体与默认清理规则，且不清楚非对话日志…
故障排查GitHub Issue
FastGPT 4.8.9版本文件类型判断不生效的排错指南
FastGPT 4.8.9版本文件类型判断不生效的排错指南 现象 FastGPT 4.8.9版本中，上传附件或图片时，使用if条件判断文件链接是否包含txt或jpg的逻辑无法正常生效，无论上传的文件类型是否符合要求，始终执行else分支。同时，单轮对话中每次上传新的文档时，系统会携带之前上传过的所有文档一起…
故障排查GitHub Issue
FastGPT无法检索指定文件名文件的排错方法
FastGPT无法检索指定文件名文件的排错方法 现象 在使用FastGPT时，尝试基于文件名检索对应文件以开展问答，无法获取目标文件。该问题出现在4.8.9版本的私有部署及公有云FastGPT环境中，用户的具体查询场景为询问特定文件内的测试项及测试目的，核心诉求为通过文件名检索到对应文件。 可能原因 无法通…
故障排查GitHub Issue
解决FastGPT配置完成后仍提示资源不存在的问题
解决FastGPT配置完成后仍提示资源不存在的问题 现象 用户在完成FastGPT的对应配置操作后，系统仍然弹出提示信息，显示配置项或资源不存在，该提示会直接阻断对应功能的正常调用，影响业务使用流程。 可能原因 该问题可能与ubaserl配置异常存在关联，异常的ubaserl配置会导致系统无法正确识别已完成…