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

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

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

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

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

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

阅读 API 指南 查看官方文档

按任务找到答案

共 4316 篇

故障排查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 分钟阅读
故障排查GitHub Issue

解决FastGPT本地部署时PG连接异常引发的栈溢出错误

解决FastGPT本地部署时PG连接异常引发的栈溢出错误 现象 本地部署FastGPT过程中，执行数据录入与查询操作时，会持续触发RangeError: Maximum call stack size exceeded错误，同时伴随PostgreSQL连接不稳定的问题。 可能原因 该问题的核心诱因为环境变量…

2 分钟阅读
故障排查GitHub Issue

FastGPT知识库从PG迁移至Milvus的导出方案指南

FastGPT知识库从PG迁移至Milvus的导出方案指南 现象 PG数据库检索耗时10至20秒，随着知识库索引增多，计划将知识库迁移至Milvus向量数据库，需保留文件层次结构与元数据的安全可靠导出方案。 可能原因 随着知识库索引规模扩大，PG数据库的检索性能下降，无法满足业务需求，因此需要更换向量数据库…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT中PG数据库向量删除后索引异常导致查询耗时问题

解决FastGPT中PG数据库向量删除后索引异常导致查询耗时问题 现象 向量存储量级超百万时，删除向量后索引无法自动重建，引发数据库查询耗时增加。 可能原因 PG数据库默认的自动真空（autovacuum）策略较为保守，无法及时回收删除向量产生的死元组，导致索引未能自动重建。 排查步骤 1. 确认存储向量的…

3 分钟阅读