故障排查GitHub Issue
解决FastGPT升级后知识库列表页面显示不兼容的问题
解决FastGPT升级后知识库列表页面显示不兼容的问题 现象 配置文件中设置了一个或以上模型的"datasetProcess": true，访问知识库列表页面（xxx/dataset/list）时显示“部分系统不兼容”。访问此前版本创建的单独知识库，可正常选择"datasetProcess": true的模…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT V4.8.23创建知识库无法选择大语言模型问题
解决FastGPT V4.8.23创建知识库无法选择大语言模型问题 现象 私有部署FastGPT V4.8.23版本时，按照官方文档完成安装，大语言模型可正常使用，但在创建知识库的流程中，无法选择大语言模型。部署环境无独立显卡。 可能原因 部署环境无独立显卡，导致部分依赖显卡的模型加载逻辑无法正常适配；或大…
故障排查GitHub Issue
解决FastGPT知识库问题优化的默认模型调用逻辑异常
解决FastGPT知识库问题优化的默认模型调用逻辑异常 现象 FastGPT私有部署v4.8版本中，config.json支持配置各模型是否可用于问题优化功能。当知识库开启问题优化且未手动选择AI模型时，系统会默认调用config.json中的第一个模型，忽略了配置项中对模型可用状态的限制，逻辑不符合预期。…
故障排查GitHub Issue
FastGPT知识库搜索时parentId失效问题排查与解决
FastGPT知识库搜索时parentId失效问题排查与解决 现象 在FastGPT 4.9.13私有部署版本中，使用知识库过滤功能时，若输入searchText（搜索关键词），parentId参数会失效。进入指定文件夹后进行字段搜索，会返回不在该文件夹内的知识库条目，查询结果包含全量知识库内容。 可能原因…
故障排查GitHub Issue
解决FastGPT知识库开场白预设问题覆盖不足问题
解决FastGPT知识库开场白预设问题覆盖不足问题 现象 知识库开场白展示的预设问题覆盖范围不足，用户点击大类问题后无法得到对应的分支引导问题，难以在短时间内定位自身所需的业务问题。 可能原因 预设的开场白问题未覆盖细分业务场景，未配置大类问题对应的分支引导问题生成逻辑。 排查步骤 1. 查看知识库中配置的…
故障排查GitHub Issue
解决FastGPT私有部署下选择知识库无法修改引用上限的问题
解决FastGPT私有部署下选择知识库无法修改引用上限的问题 现象 在FastGPT私有部署版本中，创建简单应用并选择目标知识库后，引用上限设置项无法进行修改操作，页面上的对应输入或选择控件无响应，无法完成应用调用配额的配置调整。 可能原因 当前未公开明确的通用触发原因，需结合实际部署环境的运行日志、前端控…
故障排查GitHub Issue
FastGPT 4.8.5升级后创建知识库提示数量超限的排查方法
FastGPT 4.8.5升级后创建知识库提示数量超限的排查方法 现象 将FastGPT从4.8.1版本升级至4.8.5版本后，执行创建知识库操作时，系统弹出数量超限的提示。 可能原因 可能的原因包含两类。第一类是升级过程中出现配置文件未正确同步、依赖项缺失等异常，导致知识库数量限制规则被错误触发。第二类是…
故障排查GitHub Issue
解决FastGPT接口知识库检索插件引用显示问题
解决FastGPT接口知识库检索插件引用显示问题 现象 使用接口实现的知识库检索插件时，插件生成的知识库引用内容无法在FastGPT知识库界面中正常展示，相关界面的异常状态可参考提供的三张截图示例，截图包含完整界面及控件的展示细节。 可能原因 暂未明确具体触发该问题的原因，需结合实际部署环境、插件配置及调用…
故障排查GitHub Issue
解决FastGPT工作流知识库搜索模块变量引用选项无法显示问题
解决FastGPT工作流知识库搜索模块变量引用选项无法显示问题 现象 使用阿里云主镜像的FastGPT私有部署版本中，工作流的知识库搜索模块内，选择变量引用时无法显示具体的选项。用户提供了异常状态与正常预期的两张屏幕截图，异常截图中变量选择面板无具体选项，正常截图中面板显示完整变量选项列表。 可能原因 暂无…
故障排查GitHub Issue
解决FastGPT私有部署版修改知识库片段后更新时间未变化问题
解决FastGPT私有部署版修改知识库片段后更新时间未变化问题 现象 FastGPT 4.8.12私有部署版本中，直接调用接口修改知识库片段后，知识库片段的更新时间未发生改变。该问题未在当前issue中附带明确的报错日志或异常提示截图详情。 可能原因 相关触发原因未在当前issue中明确说明，需结合实际部署…
故障排查GitHub Issue
FastGPT知识库MongoDB空间占用与上传网络错误排错
FastGPT知识库MongoDB空间占用与上传网络错误排错 现象 私有部署版本4.7.1的FastGPT出现两类问题：其一，清空并删除知识库后，MongoDB数据占用空间未减少，达到7.9GB；其二，通过远程电脑访问FastGPT时，在知识库上传文件的流程中，浏览器弹出network error提示，导致…
故障排查GitHub Issue
FastGPT 知识库训练401令牌验证失败问题排错指南
FastGPT 知识库训练401令牌验证失败问题排错指南 现象 知识库训练过程中出现401令牌验证失败报错，同时上传的文件存在部分成功、部分失败的情况。后台直接上传或通过接口上传两种方式均可能触发该问题。 可能原因 当前已知报错为401令牌验证失败，具体诱因需结合实际部署环境确认，暂无可直接锁定的固定原因。…