跳至主要内容
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 4.8.20升级后知识库搜索text index报错排查指南

FastGPT 4.8.20升级后知识库搜索text index报错排查指南 现象 使用docker-compose方式将FastGPT从4.8.19升级至4.8.20版本后，无论原有知识库还是新建知识库，均可正常创建索引，但执行知识库搜索测试时，前端控制台返回POST http://192.168.12.…

3 分钟阅读
故障排查GitHub Issue

FastGPT从v4.8.8升级至v4.8.9初始化请求报错的排查与解决

FastGPT从v4.8.8升级至v4.8.9初始化请求报错的排查与解决 现象 私有部署FastGPT v4.8.8版本时，将fastgpt和fastgpt-sandbox镜像替换为v4.8.9后，执行初始化curl命令： 返回了包含Next.js前端页面结构的HTML内容，页面包含AIapp:intro描…

2 分钟阅读
故障排查GitHub Issue

FastGPT上传文件时fastgpt-plugin EAI_AGAIN报错排错

FastGPT上传文件时fastgpt-plugin EAIAGAIN报错排错 现象 在FastGPT私有部署版本4.14.1的聊天问答窗口上传文件时，系统会提示Load systen model error, please check fastgpt-plugin，同时抛出TypeError: fetch…

2 分钟阅读
故障排查GitHub Issue

FastGPT创建知识库后上传文件报错的排错方法

FastGPT创建知识库后上传文件报错的排错方法 现象 用户使用bash <(curl -fsSL https://doc.fastgpt.cn/deploy/install.sh) --region=cn --vector=pg命令安装FastGPT，执行docker compose up -d启动容器后…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT上传文档解析提示仅支持指定格式的问题

解决FastGPT上传文档解析提示仅支持指定格式的问题 现象 在FastGPT私有部署v4.8.9版本中，启用文件上传功能后，上传txt、pdf等文档解析支持的文件，通过文档解析流程处理时，返回的解析结果为<ContentOnly support .txt, .md, .html, .pdf, .docx,…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署上传大docx文件卡住的问题

解决FastGPT私有部署上传大docx文件卡住的问题 现象 用户在FastGPT私有部署4.8.3版本中，上传7.83MB（8,212,029字节）的docx文档时，上传流程一直卡在等待状态，且未捕获到明确的报错日志信息。 可能原因 当前未获取到明确的报错日志，具体触发原因需结合实际部署环境进行确认，无通…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版本上传文件预览后入库为空的问题

解决FastGPT私有部署版本上传文件预览后入库为空的问题 现象 用户使用FastGPT v4.8-alpha3私有部署版本时，出现两类异常：其一，上传文件预览环节显示正常，但预览完成后将文件上传至知识库，知识库中显示的内容为空；其二，不经过预览直接上传文件，入库成功但内容并非Markdown格式。 可能原…

2 分钟阅读
故障排查GitHub Issue

FastGPT知识库上传自定义文本预览乱码问题排查与解决

FastGPT知识库上传自定义文本预览乱码问题排查与解决 现象 用户在使用FastGPT时，将自定义文本上传至知识库后，预览该上传的文本内容出现乱码问题，涉及FastGPT v4.13.2版本的公有云和私有部署场景。 可能原因 基于现有排查信息，可能的原因包括：上传的自定义文本的字符编码与FastGPT服务…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中用户问题偶发无法传入AI对话的问题

解决FastGPT中用户问题偶发无法传入AI对话的问题 现象 用户反馈FastGPT可正常完成问题分类，但存在用户问题偶发无法传入AI对话的情况。 可能原因 目前可参考的潜在关联因素包括：FastGPT运行环境的配置异常、请求链路的临时中断、密钥或权限的偶发异常（需按实际环境确认）。 排查步骤 1. 检查F…

1 分钟阅读
故障排查GitHub Issue

FastGPT V4.14.1升级后团队应用自定义插件丢失排查指南

FastGPT V4.14.1升级后团队应用自定义插件丢失排查指南 现象 用户升级FastGPT至V4.14.1版本后，原本在V4.14.0版本中存在的团队应用目录下的自定义插件被清空或隐藏，用户反馈该情况有点吓人。无论是否执行升级脚本，均会出现该问题，执行升级脚本后会返回特定报错信息： 对比V4.14.0…

3 分钟阅读
故障排查GitHub Issue

FastGPT v4.8.17版本POST请求Invalid JSON body报错排查

FastGPT v4.8.17版本POST请求Invalid JSON body报错排查 现象 在FastGPT私有部署版本v4.8.17中，使用HTTP请求组件发起POST请求时，会返回Invalid JSON body报错。报错关联的请求体为： 可能原因 结合报错提示，可能的原因包括：提交的POST请求…

2 分钟阅读