跳至主要内容
FASTGPT / 技术中心

从部署到 API，
直接找到可执行答案。

面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。

4244 篇内容11 个主题官方文档与公开 Issue
推荐入口
API官方文档3 分钟阅读

FastGPT对话接口API的调用方法与参数配置说明

可在应用详情的路径中获取AppId。鉴权使用APIKey，支持两种方式：调用 chat/completions 时在请求体传入 body.appId ，或通过 Authorization: Bearer apiKey - a…

阅读 API 指南 查看官方文档

按任务找到答案

共 4244 篇

故障排查GitHub Issue

解决FastGPT高级编排模块局限与数据引用异常问题

解决FastGPT高级编排模块局限与数据引用异常问题 现象 使用FastGPT高级编排功能时，http模块返回的数据无法被AI对话模块解析并用于回复用户。现有编排模块存在局限，缺少支持编排赋值的变量模块与数据判断模块，无法完成将http返回结果赋值存储、基于数据进行分支判断且不消耗token的操作。部分场景…

2 分钟阅读
故障排查GitHub Issue

FastGPT 接入 PaddleOCR-VL 增强解析的历史需求

FastGPT 接入 PaddleOCR-VL 增强解析的历史需求 适用场景与历史记录 原议题于 2025 年请求增加 PaddleOCR-VL 增强解析支持，讨论中记录了具体模型的接入需求。 原始讨论提交于 2025-10-20，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 该请求不足以确定…

2 分钟阅读
故障排查GitHub Issue

FastGPT页面因浏览器兼容或翻译设置异常导致崩溃的排查与解决

FastGPT页面因浏览器兼容或翻译设置异常导致崩溃的排查与解决 现象 部分场景下出现页面崩溃问题，多数触发场景为特定浏览器环境，或开启中文翻译功能后出现。 可能原因 一是浏览器存在兼容异常；二是系统内的中文翻译功能开启引发兼容冲突。 排查步骤 1. 记录页面崩溃时的使用环境，包括浏览器类型、是否开启中文翻…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT中/v2/parse/file接口缺失的排查问题

解决FastGPT中/v2/parse/file接口缺失的排查问题 现象 在使用FastGPT的pdf-marker插件相关功能时，发现/v2/parse/file接口无法正常访问。经检查plugins/model/pdf-marker/apimp.py源码文件，未找到该接口的相关定义。 可能原因 该接口未…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.9.7-fix2 PDF 增强首次导入失败的历史排查

FastGPT 4.9.7-fix2 PDF 增强首次导入失败的历史排查 适用场景与历史记录 原报告描述启用 PDF 增强后第一次导入报错，第二次成功；评论者声称其测试过的 PDF 均有类似表现。 原始讨论提交于 2025-05-13，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 “所有 PD…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库PDF解析后图片无法正常显示的问题

解决FastGPT知识库PDF解析后图片无法正常显示的问题 现象 使用PDF增强模式时，界面仅显示图片图标但无法加载图片；不使用增强模式时，知识库中无任何图片显示。部分部署4.9.11版本的实例中，使用增强解析Doc2X服务时，知识库预览可临时看到图片，但次日图片消失。使用官方解析服务https://doc…

2 分钟阅读
故障排查GitHub Issue

FastGPT PDF 解析后图片编辑的历史需求

FastGPT PDF 解析后图片编辑的历史需求 适用场景与历史记录 原议题希望在知识库 Markdown 编辑时支持方便的粘贴上传、增加和删除图片，以修订 PDF 解析结果。 原始讨论提交于 2025-04-22，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 线程表达的是图片编辑体验需求。图…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中PDF解析依赖marker-pdf版本过低的问题

解决FastGPT中PDF解析依赖marker-pdf版本过低的问题 现象 使用FastGPT解析PDF文件时，会生成大量垃圾标签，有效文字占比仅约10%，严重影响知识库的分段效果。当前内置的marker-pdf版本为0.3.10。 可能原因 FastGPT内置的PDF解析依赖marker-pdf版本为0.…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中PDF与PPT文件的解析适配问题

解决FastGPT中PDF与PPT文件的解析适配问题 现象 在FastGPT的使用流程中，处理PDF文件时可参考对应解析方案，但处理PPT文件时暂无合适的解析方案，无法完成文件的解析与导入流程。部分用户反馈在上传PDF或PPT文件后，解析环节出现异常，无法正常生成可用于后续对话的文本内容。 可能原因 Fas…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库检索准确率低及图片PDF解析配置问题

解决FastGPT知识库检索准确率低及图片PDF解析配置问题 现象 测试手册型PDF时，知识库检索准确率几乎为0。尝试更换不同模型与分块方式，仍无法检索出答案。部分场景下，上传图片格式PDF或调用Marker解析时，会出现解析报错。 可能原因 出现该问题的可能原因包括：知识库配置存在异常；待解析的PDF为图…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT上传PDF时提示最多支持10个文件的问题

解决FastGPT上传PDF时提示最多支持10个文件的问题 现象 上传8M大小的PDF文件时，系统弹出提示"最多只支持10个文件"。另有用户反馈上传非标准格式的PDF文件时，也会触发该提示。 可能原因 一是上传的PDF文件格式不符合标准规范；二是网关未配置足够大的文件上传大小限制，导致大文件上传时出现异常提…

1 分钟阅读
故障排查GitHub Issue

为FastGPT实现导出PDF与Word文档的解决方案

为FastGPT实现导出PDF与Word文档的解决方案 现象 用户需要为FastGPT添加非导入式的PDF、Word文档导出插件，当前无内置对应功能，无法直接完成非导入式的文档导出操作。 可能原因 当前FastGPT未提供内置的非导入式PDF、Word文档导出功能，需通过外部插件或自定义API实现对应能力。…

2 分钟阅读