故障排查GitHub Issue
解决FastGPT知识库分页返回至第一页的异常问题
解决FastGPT知识库分页返回至第一页的异常问题 现象 私有部署版本v4.9.13的FastGPT中，知识库文档较多存在分页时，在非第一页（如第2页）打开文档查看，查看结束后点击上方返回至知识库名称的按钮，会返回至第一页，无法返回至当前所在的分页页面，造成操作不便。 可能原因 该问题的具体技术根因未在当前…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
修复FastGPT知识库访问权限修改后刷新恢复的问题
修复FastGPT知识库访问权限修改后刷新恢复的问题 现象 FastGPT私有部署4.8.10版本中，将知识库访问权限从仅协作者访问修改为团队访问，点击保存后刷新页面，权限配置会恢复为修改前的仅协作者访问状态。公有云版本未出现该问题。 可能原因 目前无明确触发逻辑，相关异常需结合实际部署环境与配置细节确认。…
故障排查GitHub Issue
解决FastGPT知识库搜索与编排对话引用不一致问题
解决FastGPT知识库搜索与编排对话引用不一致问题 现象 在FastGPT私有部署版本的使用中，知识库自带的搜索测试结果准确，但在高级编排对话的测试场景下，实际搜索返回的引用内容与知识库中的预设内容完全不同。 可能原因 暂未明确具体成因，用户在issue中提及疑似与语义搜索的逻辑存在异常有关，需结合实际部…
故障排查GitHub Issue
解决FastGPT知识库导入大量内容后检索引用无关内容的问题
解决FastGPT知识库导入大量内容后检索引用无关内容的问题 现象 知识库内容较少时，回答准确性较高。一旦知识库导入大量内容之后，就会引用一些无关的内容参与回答，导致回答的结果准确性下降。当前使用混合检索+结果重排功能，引用上限为2000。 可能原因 目前无明确公开的触发原因说明，需结合实际部署环境与配置细…
故障排查GitHub Issue
解决FastGPT私有部署知识库检索结果不精确的问题
解决FastGPT私有部署知识库检索结果不精确的问题 现象 FastGPT私有部署场景下，知识库相关内容无法实现精确检索。例如知识库中存在大黄花鱼营养成分的原文，但检索返回结果未匹配到该内容，常规检索可正常获取目标内容。 可能原因 已知潜在原因为知识库文本总量较大，导致检索匹配逻辑无法精准定位目标内容。其余…
故障排查GitHub Issue
解决FastGPT知识库搜索模型默认选中不符合预期问题
解决FastGPT知识库搜索模型默认选中不符合预期问题 现象 用户在FastGPT v4.8.2版本中，创建知识库时选择了文件处理模型，但在该知识库的搜索页面，默认选中的模型为config.json配置文件中的第一个模型。 可能原因 当前未明确具体触发逻辑，需按实际部署环境确认。 排查步骤 1. 登录Fas…
故障排查GitHub Issue
解决FastGPT知识库搜索补全后用户问题未同步至输出的问题
解决FastGPT知识库搜索补全后用户问题未同步至输出的问题 现象 知识库搜索模块的用户问题补全功能生效后，补全后的用户问题内容仅应用于知识库搜索环节，未同步更新至模块输出的“用户问题”字段，导致模块输出中的“用户问题”仍为原始输入内容。 可能原因 暂无公开明确的已知触发原因，需结合实际部署环境与模块运行日…
故障排查GitHub Issue
解决FastGPT知识库搜索引用上限导致结果偏差问题
解决FastGPT知识库搜索引用上限导致结果偏差问题 现象 知识库包含上百条装备的知识，并按单个装备拆分为独立知识组。当提问"宽度最宽的坦克"时，受知识库搜索引用上限限制，返回的引用仅包含部分坦克类型的知识片段，最终生成的答案仅基于该部分召回内容，无法覆盖全量相关知识库。 可能原因 该问题的核心原因为知识库…
故障排查GitHub Issue
解决FastGPT知识库工作流配置保存后重置的问题
解决FastGPT知识库工作流配置保存后重置的问题 现象 私有部署版本v4.8.8-fix2的FastGPT中，知识库工作流的搜索参数设置和引用提示词设置保存后，间隔一段时间再次进入编辑页面时，已保存的配置参数会被重置。例如用户在9:58完成配置保存，10:15再次打开编辑页面时，配置恢复至初始状态。 可能…
故障排查GitHub Issue
解决FastGPT知识库匹配到答案却不返回的问题
解决FastGPT知识库匹配到答案却不返回的问题 现象 该问题出现在FastGPT私有部署版本中。用户使用可正常工作的密钥，确认知识库中已存在对应问题的答案，但系统未返回该答案。用户反馈仅能通过与知识库预设完全一致的提问获取答案，非完全匹配的提问无法得到结果。 可能原因 该问题与知识库的召回逻辑、回答生成的…
故障排查GitHub Issue
解决FastGPT私有部署v4.9.6知识库bool类型字段报错问题
解决FastGPT私有部署v4.9.6知识库bool类型字段报错问题 现象 FastGPT 私有部署v4.9.6版本中，知识库引用功能在输入包含bool类型字段（如"defaultIndex": false）的内容时触发报错。该报错在移除所有bool类型输入后，功能可恢复正常运行。 可能原因 FastGPT…
故障排查GitHub Issue
解决FastGPT上传知识库自定义规则回车分段失效问题
解决FastGPT上传知识库自定义规则回车分段失效问题 现象 上传知识库时，选择直接分段模式并启用自定义规则，使用\n回车进行分段的操作无法正常完成内容拆分。该问题在多设备部署的项目中均出现，具有普遍性。 可能原因 具体触发该分段失效的逻辑未在issue中明确，需结合实际部署环境、配置项细节进一步确认。 排…