故障排查GitHub Issue
FastGPT 4.8.9版本文件类型判断不生效的排错指南
FastGPT 4.8.9版本文件类型判断不生效的排错指南 现象 FastGPT 4.8.9版本中，上传附件或图片时，使用if条件判断文件链接是否包含txt或jpg的逻辑无法正常生效，无论上传的文件类型是否符合要求，始终执行else分支。同时，单轮对话中每次上传新的文档时，系统会携带之前上传过的所有文档一起…
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.9版本的私有部署及公有云FastGPT环境中，用户的具体查询场景为询问特定文件内的测试项及测试目的，核心诉求为通过文件名检索到对应文件。 可能原因 无法通…
故障排查GitHub Issue
解决FastGPT配置完成后仍提示资源不存在的问题
解决FastGPT配置完成后仍提示资源不存在的问题 现象 用户在完成FastGPT的对应配置操作后，系统仍然弹出提示信息，显示配置项或资源不存在，该提示会直接阻断对应功能的正常调用，影响业务使用流程。 可能原因 该问题可能与ubaserl配置异常存在关联，异常的ubaserl配置会导致系统无法正确识别已完成…
故障排查GitHub Issue
解决FastGPT长对话上下文超出token上限的异常问题
解决FastGPT长对话上下文超出token上限的异常问题 现象 在FastGPT AI界面配置上下文token上限后，当上下文累计内容超出设定阈值时，部分部署场景下会出现无回复的交互异常。如使用vllm部署的模型场景下，超字数会直接卡住无回复。部分用户尝试实现上下文内容压缩以支持长对话，但压缩操作本身会消…
故障排查GitHub Issue
解决FastGPT导入动态渲染网页内容抓取失败的问题
解决FastGPT导入动态渲染网页内容抓取失败的问题 现象 导入网页链接时，无法有效提取依赖纯前端渲染（数据包含在script标签中）的网站内容，例如https://tenancy.dev这类站点。 可能原因 现有网页抓取逻辑未执行JavaScript渲染网页源代码，导致无法获取动态生成的页面内容。 排查步…
故障排查GitHub Issue
解决FastGPT中嵌入模型维度超出预设限制的问题
解决FastGPT中嵌入模型维度超出预设限制的问题 现象 在FastGPT中使用Qwen-7B-chat模型的嵌入功能时，该模型的嵌入输出维度为4096，超出FastGPT预设的1536维度限制，导致嵌入服务无法正常运行。此类问题会直接影响基于嵌入功能的相关业务流程，无法正常生成或返回嵌入结果。 可能原因…
故障排查GitHub Issue
解决FastGPT上传图片无文字输入时提示输入为空的问题
解决FastGPT上传图片无文字输入时提示输入为空的问题 现象 使用多模态模型时，仅上传图片且未输入文字提问，系统会提示输入为空，影响使用体验。 可能原因 系统未针对仅上传图片且无文字输入的场景做适配，直接触发了输入为空的校验逻辑，导致报错。 排查步骤 1. 确认当前使用的是多模态模型，且仅上传图片未输入文…
故障排查GitHub Issue
解决FastGPT中发送图片链接提示无法访问外部链接的问题
解决FastGPT中发送图片链接提示无法访问外部链接的问题 现象 本地上传的图片可被识别，但发送图片链接给GPT时，系统提示无法访问外部链接。 可能原因 该问题源于输入框文本转换为API参数的逻辑异常。图片链接未被正确转换为适配视觉模型的参数，且不同FastGPT版本的处理机制存在差异，部分版本直接输入链接…
故障排查GitHub Issue
解决FastGPT中飞书文档同步后无图片的问题
解决FastGPT中飞书文档同步后无图片的问题 现象 在使用FastGPT同步飞书文档的过程中，同步生成的内容未包含原飞书文档中的图片资源，导致最终展示的内容存在缺失，无法完整还原原文档的全部信息。 可能原因 由于本次问题的具体触发逻辑未在相关线程中明确提及，无法直接确定根本原因，需结合实际的FastGPT…
故障排查GitHub Issue
排查与解决FastGPT免登录分享链接不定期失效问题
排查与解决FastGPT免登录分享链接不定期失效问题 现象 FastGPT 4.7.1版本本地部署场景中，免登录右下角小标形式的分享链接会不定期失效，点击进入后页面显示分享链接失效。失效时链接的shareID字符发生变化。该应用使用知识库与AI对话模块，近期未进行配置修改、重置或生成新链接操作，使用频率为每…
故障排查GitHub Issue
解决FastGPT多轮对话重复检索知识库与Token占用过高问题
解决FastGPT多轮对话重复检索知识库与Token占用过高问题 现象 每一次问答都调用知识库，产生大量无用Token占用，拖长回答时间。多轮对话中，即使上一轮问答已召回相关知识库分块，仍会重复检索，导致上下文冗余，难以记住前序问题。 可能原因 多轮对话编排逻辑存在缺陷，未添加条件判断，每次问答都执行知识库…
故障排查GitHub Issue
解决FastGPT 4.8.22中think标签思考过程输出不稳定的问题
解决FastGPT 4.8.22中think标签思考过程输出不稳定的问题 现象 在FastGPT 4.8.22版本中，设置提示词要求模型输出思考过程后，首次提问可正常返回思考过程与结果，后续提问出现异常。部分场景下，提示词要求先回答再输出思考过程时，也无法正常输出思考过程。部分情况下仅返回最终答案，无思考过…