跳至主要内容
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自定义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 分钟阅读
故障排查GitHub Issue

解决FastGPT与pgvector v0.7.0+的知识库搜索失败问题

解决FastGPT与pgvector v0.7.0+的知识库搜索失败问题 现象 当使用搭载pgvector扩展v0.7.0或更高版本的PostgreSQL数据库时，FastGPT的知识库搜索功能会间歇性失败。PostgreSQL容器日志会频繁出现致命错误： 前端也会报相同错误文本，或出现警告但查询依然失败。…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中pgvector的版本与调用异常问题

解决FastGPT中pgvector的版本与调用异常问题 现象 在使用FastGPT的过程中，部署的pgvector容器镜像版本为v0.5.1，该镜像最后更新时间为7个月前，无法匹配官方最新版本，且调用该向量数据库时相关工具支持不足。 可能原因 官方pgvector仓库已更新至v0.6.2版本，但公开的pg…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT PgVector部署版上传图片无法显示的排错方法

解决FastGPT PgVector部署版上传图片无法显示的排错方法 现象 使用FastGPT私有部署V4.8.14-fix版本的PgVector部署模式时，上传图片后无法正常显示。后台日志显示Upload file success trainingloss.png, cost 16ms，文本问答功能可正常…

2 分钟阅读