故障排查GitHub Issue
FastGPT知识库上传训练后停滞及参数错误的排错方法
FastGPT知识库上传训练后停滞及参数错误的排错方法 现象 在FastGPT私有部署版本4.8.9的环境中，用户创建知识库并上传文件后，训练进度条无任何变化。系统日志提示prompt参数不正确，向量模型没找到，前端页面同步出现对应报错。用户已按照官方文档配置向量模型，且在渠道配置中也完成了向量模型的设置。…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT点击知识库时页面崩溃的排错方法
解决FastGPT点击知识库时页面崩溃的排错方法 现象 FastGPT流程可正常运行并回答问题，查看详情页的其他控件点击均正常，但点击知识库控件时页面立即崩溃。该问题跨版本存在，docker logs无错误日志，页面出现未捕获的异常，通过F12控制台可查看到Minified React error #300…
故障排查GitHub Issue
解决FastGPT知识库编号类关键词检索失败问题
解决FastGPT知识库编号类关键词检索失败问题 现象 用户导入包含编号/型号数据的知识库后，通过Q&A训练和文档上传操作，确保编号关键词被知识库内容多次覆盖。使用语义检索、全文检索功能时，均无法检索到对应编号的知识段落，相关检索结果截图显示未返回目标编号的知识内容，最终导致机器人回答与实际知识库内容不符，…
故障排查GitHub Issue
解决FastGPT私有部署版本知识库搜索无返回数据问题
解决FastGPT私有部署版本知识库搜索无返回数据问题 现象 FastGPT私有部署4.8.22-alpha版本，使用PostgreSQL数据库时，按照上传PDF文档、进入知识库测试搜索的流程操作后，搜索结果为空，但数据库中实际存在对应知识库数据。查看FastGPT容器日志发现执行了带分页的SQL查询语句，…
故障排查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…