故障排查GitHub Issue
解决FastGPT集成LanceDB向量存储组件的相关配置问题
解决FastGPT集成LanceDB向量存储组件的相关配置问题 现象 需按实际环境确认具体异常表现，仅已知存在将LanceDB作为FastGPT向量存储组件的集成需求，未明确具体报错信息或配置失败场景。 可能原因 暂无明确的通用排查原因，需结合实际部署环境、FastGPT版本配置以及LanceDB的部署状态…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT聊天框大文件上传无法识别内容的问题
解决FastGPT聊天框大文件上传无法识别内容的问题 现象 FastGPT聊天框上传小文件可正常返回结果，上传大文件时无法识别文件内容。该场景未出现内容被截断的情况，大模型无法接收到文件相关内容。用户已提供相关运行日志截图辅助排查。 可能原因 暂未明确官方指定的直接原因，需结合实际部署环境排查。可能的关联方…
故障排查GitHub Issue
解决FastGPT上传超过20M知识库文件时的报错问题
解决FastGPT上传超过20M知识库文件时的报错问题 现象 私有部署的FastGPT 4.7.1版本中，上传知识库文件时首次上传无报错，后续上传超过一定大小的文件时出现报错，报错关联MongoDB数据库。用户反馈该问题仅在后续上传大文件时触发，首次上传操作正常。 可能原因 报错提示关联MongoDB数据库…
故障排查GitHub Issue
解决FastGPT私有部署4.8.6版本大文件上传中断问题
解决FastGPT私有部署4.8.6版本大文件上传中断问题 现象 FastGPT私有部署4.8.6版本中，大文件上传经常突然中断，上传行为不稳定，有时可正常完成上传，有时直接中断失败。 可能原因 暂无明确的已知触发原因，需结合实际部署环境确认。 排查步骤 1. 确认上传文件的大小是否符合当前部署的上传限制配…
故障排查GitHub Issue
解决FastGPT应用交互上传大文件时的超时报错问题
解决FastGPT应用交互上传大文件时的超时报错问题 现象 FastGPT应用的交互流程中，上传大文件时会触发超时报错提示，该问题为用户反馈的具体使用异常。 可能原因 当前issue未提供明确的异常指向原因，无法直接确定通用的故障根源，需结合实际部署环境、配置参数以及系统运行日志进行针对性排查，无预设的通用…
故障排查GitHub Issue
解决FastGPT listV2接口parentId过滤失效问题
解决FastGPT listV2接口parentId过滤失效问题 现象 调用FastGPT的/api/core/dataset/collection/listV2接口时，无论请求参数中parentId传入具体值还是null，返回结果均包含不属于该parentId的内容，未按parentId参数完成过滤。 可…
故障排查GitHub Issue
解决FastGPT v4.9.10版Llama3.3-70b工具调用输出中文的问题
解决FastGPT v4.9.10版Llama3.3-70b工具调用输出中文的问题 现象 在FastGPT私有部署版v4.9.10中，使用Llama3.3-70b模型且全英文环境时，即system prompt、工具描述、工具输出、用户输入均为英文，最终生成的回答为中文。在system prompt中强制要…
故障排查GitHub Issue
FastGPT本地私有Deepseek模型调用异常排查指南
FastGPT本地私有Deepseek模型调用异常排查指南 现象 私有部署FastGPT环境中，调用本地私有Deepseek模型时出现调用异常，附带两张报错截图，未明确给出具体报错文本内容。 可能原因 结合当前场景分析，可能的原因包括本地私有模型的接口配置不符合FastGPT要求、本地模型接口的访问权限未正…
故障排查GitHub Issue
解决本地部署FastGPT后模型渠道页面报错及类型为空的问题
解决本地部署FastGPT后模型渠道页面报错及类型为空的问题 现象 使用最新镜像部署本地开发环境且未修改配置，部署完成后打开模型渠道页面会出现报错，且渠道类型为空。直接下载Docker镜像部署无该问题。 可能原因 暂无明确的已知匹配原因，需结合本地部署的构建、依赖加载环节实际情况确认。仅可明确本地开发环境部…
故障排查GitHub Issue
解决FastGPT v4.8.1私有部署本地开发启动卡在ready的问题
解决FastGPT v4.8.1私有部署本地开发启动卡在ready的问题 现象 FastGPT v4.8.1私有部署版本在执行快速本地开发流程时，控制台打印停止在ready节点，无后续日志输出，疑似运行过程出现阻塞。 可能原因 未明确具体触发原因，需结合实际运行环境确认。潜在可能包括依赖加载异常、端口冲突、…
故障排查GitHub Issue
解决FastGPT 4.6.8私有部署版本地Docker构建后启动报错问题
解决FastGPT 4.6.8私有部署版本地Docker构建后启动报错问题 现象 本地修改FastGPT 4.6.8私有部署版代码逻辑后，执行docker build -t 镜像名称 --build-arg name=app --build-arg proxy=taobao .命令构建镜像，通过docker…
故障排查GitHub Issue
解决FastGPT私有部署版本地嵌入模型自动分割预处理失效问题
解决FastGPT私有部署版本地嵌入模型自动分割预处理失效问题 现象 使用fastgpt-Milvus v4.8.20-fix2 docker compose部署版本的场景中，添加本地嵌入模型时，配置模型官方参数维度768、最大tokens 512。在知识库数据处理环节，选择自动设置分割和预处理规则时无法正…