故障排查GitHub Issue
解决FastGPT中LLM短回复触发LLM_model_response_empty报错问题
解决FastGPT中LLM短回复触发LLMmodelresponseempty报错问题 现象 用户使用FastGPT私有部署V4.9.8版本时，当大模型回复内容较短，AI对话组件会触发LLMmodelresponseempty报错。例如在翻译插件场景中，用户输入“你好”，模型返回“hello”时，会触发该报…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT聊天回复长度不符合预期的问题
解决FastGPT聊天回复长度不符合预期的问题 现象 用户使用私有部署版本的FastGPT构建聊天应用，未配置知识库等额外设置。即使将回复上限调整至8000，生成的聊天回复仍较短，未达到用户预期的长度。 可能原因 该问题可能与模型调用的maxtokens参数配置有关。部分场景下，该参数的默认值或手动设置值未…
故障排查GitHub Issue
解决FastGPT私有部署版简易应用数据库连接工具调用失效问题
解决FastGPT私有部署版简易应用数据库连接工具调用失效问题 现象 FastGPT私有部署v4.10.0版本中，简易应用配置数据库连接工具后，创建工具时可正常使用，但经过一段时间后再次调用该工具会出现异常，需删除该工具后重新添加才能恢复正常。同时，系统内其他工作流中的数据库连接操作可以正常执行，未出现同类…
故障排查GitHub Issue
解决FastGPT接入One-API后调用星火模型返回10013错误的问题
解决FastGPT接入One-API后调用星火模型返回10013错误的问题 现象 使用私有部署v4.7版本的FastGPT，接入One-API后调用SparkDesk-v3.5模型时，无论输入内容或知识库是否为空，均返回10013错误。在One-API内进行渠道测试可正常通过，且该模型通过One-API接入…
故障排查GitHub Issue
解决FastGPT指定回复场景下无法插入空行的问题
解决FastGPT指定回复场景下无法插入空行的问题 现象 用户在使用FastGPT的指定回复功能时，可通过\n或直接回车实现单行换行，但无法实现两段文字间的空行。用户尝试了三种方式均失败：一是使用多个\n，二是直接多次回车，三是在两行文字间添加空格占位后换行，均无法在两行之间生成空行。用户的使用场景为在提示…
故障排查GitHub Issue
解决FastGPT接入第三方语音识别模型后识别超时的问题
解决FastGPT接入第三方语音识别模型后识别超时的问题 现象 用户使用fastgpt v4.8.9搭配oneapi 0.6.8部署第三方语音识别模型iic/SenseVoiceSmall时，最初出现渠道找不到的报错。通过在OneAPI渠道和令牌中添加whisper-1模型名解决了该问题。使用issue中提…
故障排查GitHub Issue
解决FastGPT语音转录效果差与延迟高的优化方案
解决FastGPT语音转录效果差与延迟高的优化方案 现象 当前FastGPT使用Whisper进行离线语音转录，存在中文转录效果一般、延迟较大的问题，无法满足实时性业务的使用需求。 可能原因 原语音转录方案采用Whisper离线模式，未针对实时场景做针对性优化，导致整体延迟偏高，同时中文转录效果存在不足。…
故障排查GitHub Issue
修复FastGPT中splitText2Chunks的分段异常问题
修复FastGPT中splitText2Chunks的分段异常问题 现象 使用FastGPT的splitText2Chunks函数处理文本时，可能出现三类异常：递归分段时无重叠长度、返回结果末尾存在过小分段且无法合并到后续分段、特定分段结构下文本顺序被打乱。当输入文本被拆分为小片段、正常长度片段组合、小片段…
故障排查GitHub Issue
排查并修复FastGPT中的400状态码SSE报错问题
排查并修复FastGPT中的400状态码SSE报错问题 现象 在使用FastGPT时，服务端日志会输出类似以下内容的报错： 同时伴随包含400状态码的错误堆栈，堆栈信息显示错误源自OpenAI SDK的请求调用，涉及Next.js服务端的contentExtract、chatTest等路由链路。 可能原因…
故障排查GitHub Issue
解决FastGPT部署运行中出现sse error bad_response_status_code 500报错问题
解决FastGPT部署运行中出现sse error badresponsestatuscode 500报错问题 现象 在FastGPT运行过程中，控制台会输出如下格式的错误日志： 该错误伴随500内部服务错误，错误栈显示调用链路涉及generate、makeRequest、datasetSearchNode…
故障排查GitHub Issue
解决FastGPT中SSE解析不完整chunk导致内容显示不全的问题
解决FastGPT中SSE解析不完整chunk导致内容显示不全的问题 现象 使用FastGPT时，SSE流式返回的内容仅显示部分，剩余内容无法正常加载或展示。不完整的chunk会导致后续的chunk无法正常解析为JSON格式，最终仅返回部分解析结果。 可能原因 问题源于原代码中SSEParseData类的p…
故障排查GitHub Issue
解决FastGPT中SSE流式响应JSON解析失败的问题
解决FastGPT中SSE流式响应JSON解析失败的问题 现象 服务端抛出Could not parse message into JSON报错，伴随具体语法错误SyntaxError: Unexpected token { in JSON at position 212。日志中会打印原始的SSE chun…