跳至主要内容
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 v4.9.3版本PDF增强解析Internal Server Error排错方案

FastGPT v4.9.3版本PDF增强解析Internal Server Error排错方案 现象 使用FastGPT私有部署v4.9.3版本时，在对PDF文档执行增强解析并上传的操作中，页面返回Internal Server Error错误，无法正常完成PDF文档的增强解析上传流程。 可能原因 暂未明…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版PDF增强处理长时间卡住问题

解决FastGPT私有部署版PDF增强处理长时间卡住问题 现象 选择任意PDF进行增强处理时，任务持续卡住超过1小时未完成数据训练。部署FastGPT的服务器CPU、内存使用率处于正常范围，数据库负载也无异常，FastGPT控制台日志未显示报错信息。用户上传了两张任务界面截图，但未在描述中补充具体的界面文字…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中PDF识别后HTML表格无法正确预览渲染的问题

解决FastGPT中PDF识别后HTML表格无法正确预览渲染的问题 现象 使用改进后的MinerU处理PDF文件后，识别得到的HTML格式表格无法在FastGPT中正确预览渲染，该问题在复杂表格的PDF场景中出现。 可能原因 目前暂未明确具体技术原因，仅已知该问题出现在复杂表格PDF经识别转换为HTML表格…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT自定义PDF解析服务连接被拒绝的问题

解决FastGPT自定义PDF解析服务连接被拒绝的问题 现象 私有部署版本v4.9.9的FastGPT通过Docker与marker服务一同部署后，修改FastGPT配置文件，将customPdfParse.url配置为http://127.0.0.1:7231/v2/parse/file。使用PDF增强解…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.9.0私有部署marker v2解析PDF报错的问题

解决FastGPT 4.9.0私有部署marker v2解析PDF报错的问题 现象 用户使用私有部署的FastGPT 4.9.0，配置marker v2版本并勾选PDF增强解析功能后，上传PDF点击开始上传触发报错。marker日志显示所有模型均成功加载到CUDA设备，但在Recognizing layou…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT PDF抽取问答对时的LLM请求超时问题

解决FastGPT PDF抽取问答对时的LLM请求超时问题 现象 用户在FastGPT私有部署4.8.23-fix2版本中，执行PDF抽取问答对任务时，日志频繁出现报错信息。日志包含[Info] 2025-03-04 11:41:36 [QA Queue] Start，随后多次出现[Error] LLM r…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版PDF上传知识库解析为空问题

解决FastGPT私有部署版PDF上传知识库解析为空问题 现象 FastGPT私有部署4.8.1版本中，上传特定PDF文件至知识库后，知识库预览页面显示内容为空。本次触发问题的文件为SAP安装手册INSTOP2022.pdf，上传后后台生成对应解析错误日志，相关界面截图与日志截图可参考issue提供的内容。…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版PDF/Word知识库上传后无数据问题

解决FastGPT私有部署版PDF/Word知识库上传后无数据问题 现象 使用Docker部署V4.8.21私有部署版本的FastGPT，上传TXT和MarkDown格式文件时，可正常完成上传与拆分流程。但PDF和Word文档上传时，进度显示100%，进入数据处理步骤后，来源列表中的文件消失。点击下一步后仅…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT启动时PostgreSQL连接参数解析失败的问题

解决FastGPT启动时PostgreSQL连接参数解析失败的问题 现象 执行pnpm dev启动FastGPT项目时，控制台会打印Next.js启动信息，包括Environments: .env.local，随后打印MongoDB连接成功的日志，加载systemConfigs、appplugingroup…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT main分支PG数据库初始化索引报错问题

解决FastGPT main分支PG数据库初始化索引报错问题 现象 使用FastGPT main分支（20240102版本）源码启动时，PG数据库初始化抛出报错：CREATE INDEX CONCURRENTLY cannot run inside a transaction block，报错日志指向pac…

4 分钟阅读
故障排查GitHub Issue

解决FastGPT中pgvector连接被写入操作耗尽的问题

解决FastGPT中pgvector连接被写入操作耗尽的问题 现象 私有部署FastGPT 4.9.13版本时，当持续执行大量向量写入操作（单团队涉及几十万数据拆分的大量chunk），同时有业务查询请求，pgvector的最大连接数（配置为500-1000）会被写操作耗尽，出现too many client…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署高维度Embedding索引报错问题

解决FastGPT私有部署高维度Embedding索引报错问题 现象 用户在FastGPT 4.8.1私有部署版本中，使用Ollama上的Qwen:72b模型生成Embedding向量时，出现PG Vector索引维度限制报错，无法正常创建或使用向量索引。报错提示Embedding维度不能超过1536，PG…

2 分钟阅读