故障排查GitHub Issue
解决FastGPT私有部署版本知识库搜索无返回数据问题
解决FastGPT私有部署版本知识库搜索无返回数据问题 现象 FastGPT私有部署4.8.22-alpha版本，使用PostgreSQL数据库时，按照上传PDF文档、进入知识库测试搜索的流程操作后，搜索结果为空，但数据库中实际存在对应知识库数据。查看FastGPT容器日志发现执行了带分页的SQL查询语句，…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
解决单知识库空引用时知识库搜索引用合并导致流程中断的问题
解决单知识库空引用时知识库搜索引用合并导致流程中断的问题 现象 当使用工具调用配合知识库搜索引用合并功能时，若问题仅关联单个知识库，且该知识库的搜索引用为空，流程会停止，无法继续执行后续的AI对话步骤。例如提问“信息科技课标主要内容，100字总结”，仅关联信息科技课标知识库，此时另一关联项的引用为空，流程直…
故障排查GitHub Issue
解决FastGPT本地化部署知识库检索分值超出0-1范围问题
解决FastGPT本地化部署知识库检索分值超出0-1范围问题 现象 用户本地化部署FastGPT后，测试知识库检索时发现语义检索返回的分值为162，而官方说明相似度分值应处于0-1区间内。同时出现无论提问什么内容，AI都会无差别命中知识库的情况，本次部署使用了chatGLM3与m3e模型。 可能原因 暂未明…
故障排查GitHub Issue
FastGPT混合检索结果异常及检索性能优化排错方法
FastGPT混合检索结果异常及检索性能优化排错方法 现象 用户在私有部署的FastGPT中导入40万条、约4千万汉字的数据集至知识库后，遇到以下问题：混合检索时部分结果仅返回语义检索结果，部分同时返回语义检索与全文检索结果；部分检索结果相关性不符合预期；初始检索耗时约8秒，调整PostgreSQL参数后降…
故障排查GitHub Issue
解决FastGPT私有部署版本知识库索引完成后搜索为空的问题
解决FastGPT私有部署版本知识库索引完成后搜索为空的问题 现象 使用FastGPT v4.8.20-fix2私有部署版本时，知识库数十万条数据完成索引后，执行语义检索测试提示"搜索结果为空"。在索引建立过程中曾可正常搜索到内容，索引完成后无法搜索到任何知识库数据。 可能原因 结合问题场景，可能的原因包括…
故障排查GitHub Issue
解决FastGPT无法自动化评测知识库搜索精度的问题
解决FastGPT无法自动化评测知识库搜索精度的问题 现象 当前FastGPT仅支持手动发起搜索测试，无法通过自动化流程完成知识库搜索精度的客观评估，也无法生成可量化的搜索性能指标。 可能原因 FastGPT当前版本未内置自动化搜索精度评测的功能，仅提供手动测试的交互入口。 排查步骤 1. 确认当前Fast…
故障排查GitHub Issue
解决FastGPT知识库上传表格后换行失效与合并表格无法识别问题
解决FastGPT知识库上传表格后换行失效与合并表格无法识别问题 现象 用户在FastGPT知识库中上传含表格的docx文件后，出现两个异常问题：一是表格内的换行失效，展示为<br<br标签；二是合并格式的表格无法被正常识别。搜索该知识库时，返回的结果与原文件的表格格式不符，无法正确还原原表格的排版与内容。…
故障排查GitHub Issue
解决FastGPT知识库无法批量移动集合与条目的问题
解决FastGPT知识库无法批量移动集合与条目的问题 现象 用户在FastGPT知识库中整理内容时，需将多个相关集合或条目移动到同一父集合或重新分类时，即使已升级到最新版本，仍仅支持单条操作。单次仅能移动一个集合或条目，操作耗时较长，且易因重复操作出现分类错误。临时调整知识库结构时，无法通过批量操作快速完成…
故障排查GitHub Issue
解决FastGPT中通过知识库名称动态选择检索知识库的配置问题
解决FastGPT中通过知识库名称动态选择检索知识库的配置问题 现象 FastGPT 4.8私有部署版本中，在知识库搜索组件内尝试使用知识库名称作为变量引用，无法触发对应知识库的检索功能。使用固定配置知识库ID的方式则可以正常完成检索。配置固定知识库时的标准JSON格式为[{"datasetId":"{{d…
故障排查GitHub Issue
解决FastGPT 4.9.6版本知识库问答后图片域名异常的问题
解决FastGPT 4.9.6版本知识库问答后图片域名异常的问题 现象 FastGPT 4.9.6私有部署版本中，知识库内的图片在预览阶段可正常显示，但在问答环节偶发无法加载的问题。其中，手动上传到nginx /images静态目录的markdown图片、pdf解析生成的base64嵌入图片（路径格式为/a…
故障排查GitHub Issue
解决FastGPT私有部署版知识库增强模式导入无效果问题
解决FastGPT私有部署版知识库增强模式导入无效果问题 现象 使用私有部署4.6.9版本的FastGPT时，在知识库增强模式下导入知识后无任何效果。OneAPI未收到对应的QA请求，数据库中可查询到trainingdata任务处于排队状态。 可能原因 该问题的核心表现为训练任务进入数据库队列后未被正常消费…
故障排查GitHub Issue
解决FastGPT知识库搜索时配额不足报错的问题
解决FastGPT知识库搜索时配额不足报错的问题 现象 私有部署V4.8.9版本的FastGPT，在进行知识库搜索测试时，出现报错user [3446] quota [-20847155]preConsumedQuota [743]is not enough。此时OneAPI显示有可用余额，且对话接口可正常…