故障排查GitHub Issue
解决FastGPT拖入Markdown文件仅支持多文件无法单文件上传的问题
解决FastGPT拖入Markdown文件仅支持多文件无法单文件上传的问题 现象 该异常可通过拖入任意Markdown文件稳定复现，异常表现为仅允许拖入两个及以上文件，无法单个拖入Markdown文件。 可能原因 该issue未提供具体部署环境、配置参数或报错日志，无公开的明确关联配置项或代码逻辑说明，具体…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT使用marker_pdf解析多页复杂PDF返回504超时问题
解决FastGPT使用markerpdf解析多页复杂PDF返回504超时问题 现象 使用FastGPT 4.9.0私有部署版本，接入markerpdf解析50多页复杂PDF时，因服务器显存为16G，解析过程耗时3至5分钟，最终请求返回504超时错误。 可能原因 长耗时的PDF解析任务超出了系统预设的请求超时…
故障排查GitHub Issue
解决FastGPT中marker-pdf解析大PDF时前端超时误导问题
解决FastGPT中marker-pdf解析大PDF时前端超时误导问题 现象 本地部署marker-pdf解析器后，上传页数过多的PDF文件，解析耗时超过前端网络请求的默认超时时间。此时前端页面显示"错误"提示，但文件实际已成功上传至知识库，提示内容存在误导性。 可能原因 前端网络请求设置了默认超时阈值，当…
故障排查GitHub Issue
解决FastGPT中AI模型回复上限参数配置不生效的问题
解决FastGPT中AI模型回复上限参数配置不生效的问题 现象 在FastGPT 4.6.9及4.7.1版本中，配置AI模型的回复上限参数后，该设置未生效。大模型API服务端接收的请求中，未包含该回复上限的数值。 可能原因 已知该配置未被传递至大模型API的请求参数中，具体触发原因需按实际部署环境确认。 排…
故障排查GitHub Issue
FastGPT调用第三方服务时maxContent配置不生效的排查指南
FastGPT调用第三方服务时maxContent配置不生效的排查指南 现象 FastGPT 4.8.10-fx版本搭配oneapi 0.6.7运行环境中，调用ollama或xinference服务时，config.json配置文件内设置的maxContent参数未按预期生效。用户上传了相关服务的运行日志截…
故障排查GitHub Issue
FastGPT 4.9.13版本配置MCP工具后返回400错误排查
FastGPT 4.9.13版本配置MCP工具后返回400错误排查 现象 私有部署FastGPT 4.9.13版本时，创建MCP工具集并配置到简易应用后，调用工具会返回400错误。本地通过cherrystudio测试MCP服务无异常。 可能原因 需结合实际部署环境确认，可能包括MCP工具集配置参数异常、接口…
故障排查GitHub Issue
解决FastGPT 4.9.11版MCP鉴权配置value字段截断问题
解决FastGPT 4.9.11版MCP鉴权配置value字段截断问题 现象 在FastGPT私有部署4.9.11版本中，配置MCP鉴权信息时，value字段的长度限制过短，较长的鉴权key会被自动截断。 可能原因 MCP鉴权配置的value字段预设长度阈值不足，无法容纳较长的鉴权key内容。 排查步骤 1…
故障排查GitHub Issue
解决FastGPT中MCP调用效果不符合预期的问题
解决FastGPT中MCP调用效果不符合预期的问题 现象 使用FastGPT测试MCP调用时，在多个场景下无法完成预设操作，部分调用返回结果与预设目标存在明显偏差。累计测试二十余个不同场景的案例，整体调用效果不符合预期。 可能原因 当前FastGPT中MCP调用的提示词配置逻辑，无法适配部分场景的调用需求，…
故障排查GitHub Issue
FastGPT私有部署后工作台MCP服务不显示的排错方法
FastGPT私有部署后工作台MCP服务不显示的排错方法 现象 进入FastGPT私有部署版本的工作台后，无法看到MCP服务的相关选项，界面无对应展示内容，相关情况与问题反馈的展示一致。 可能原因 当前无明确的通用关联原因，所有可能触发该问题的因素需结合实际部署环境、配置项及运行日志逐一确认，无法通过单一条…
故障排查GitHub Issue
解决FastGPT私有部署版无参MCP工具调用报错问题
解决FastGPT私有部署版无参MCP工具调用报错问题 现象 使用FastGPT私有部署商业版4.11.0，搭载qwen3-30b模型并开启tool功能时，调用无需传参的MCP工具会触发报错。创建简易应用挂载系统自带时间工具，询问当前时间，工具可被调用但系统返回400错误，报错原因为调用模型参数异常。 可能…
故障排查GitHub Issue
解决FastGPT私有部署中MCP服务参数类型不匹配问题
解决FastGPT私有部署中MCP服务参数类型不匹配问题 现象 FastGPT私有部署场景下，MCP服务解析得到的参数为array数组类型，但调用模型服务时传递的参数为string类型，该问题会导致依赖该参数的模型调用失败，无法完成预期功能。 可能原因 该问题的核心表现为参数类型不匹配，具体触发原因需结合实…
故障排查GitHub Issue
解决FastGPT门户设置中无法添加MCP服务或团队应用为工具的问题
解决FastGPT门户设置中无法添加MCP服务或团队应用为工具的问题 现象 在FastGPT门户设置的工具调用配置页面中，无法找到添加MCP服务或团队应用的入口，无法将其纳入可调用工具列表，导致无法接入非系统插件服务，难以丰富门户模型的工具选择范围。 可能原因 需按实际环境确认，目前未明确具体的故障原因。结…