跳至主要内容
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指定版本Docker镜像拉取失败问题

解决FastGPT指定版本Docker镜像拉取失败问题 现象 执行Docker镜像拉取命令时出现失败报错，包含两种典型报错文本： 1. Error response from daemon: invalid reference format 2. Error response from daemon: ma…

2 分钟阅读
故障排查GitHub Issue

优化Docker部署的FastGPT知识库检索速度

优化Docker部署的FastGPT知识库检索速度 现象 使用Docker部署FastGPT的场景下，知识库包含数十万条数据时，单次知识库检索耗时约10秒。 可能原因 相关容器的内存资源分配不足，不足以支撑数十万条知识库数据的检索运算，导致检索速度缓慢。 排查步骤 1. 查看当前Docker部署的FastG…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT Docker部署上传大文件时出现502错误的问题

解决FastGPT Docker部署上传大文件时出现502错误的问题 现象 使用Docker部署的FastGPT，上传小文件可正常完成，上传约7M的大文件时出现502错误。服务器存储空间与系统资源充足，FastGPT运行日志无异常。 可能原因 该问题的可能原因为FastGPT运行进程出现内存溢出（OOM）。…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT Docker部署后无法新建知识库的问题

解决FastGPT Docker部署后无法新建知识库的问题 现象 Docker部署FastGPT后，可正常进入系统、完成注册账号操作，但无法新建知识库。使用最新版docker-compose镜像部署时，进入PostgreSQL容器并连接数据库后，输入init.sql无任何输出。 可能原因 首次部署时init…

1 分钟阅读
故障排查GitHub Issue

解决Docker部署FastGPT后OneAPI无端口映射无法访问的问题

解决Docker部署FastGPT后OneAPI无端口映射无法访问的问题 现象 用Docker部署FastGPT后，可正常登录FastGPT，但OneAPI无法访问。执行docker ps命令，发现OneAPI未映射端口。修改过docker-compose.yml中的FEDOMAIN参数与OPENAIBAS…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署Docker环境上传文件大小超限问题

解决FastGPT私有部署Docker环境上传文件大小超限问题 现象 本地Docker部署FastGPT时，上传文件操作失败，出现与文件大小相关的异常。 可能原因 FastGPT代码层面限制文件最大传输大小为500M，同时部署环境的网关未允许传输超出该阈值的内容，导致上传失败。 排查步骤 1. 确认待上传文…

1 分钟阅读
故障排查GitHub Issue

FastGPT 文档排版修订：textlint 自动修复的历史案例

FastGPT 文档排版修订：textlint 自动修复的历史案例 适用场景与历史记录 原议题涉及项目文档的中文排版规范；贡献者报告批量 textlint --fix 会改变部分列表、代码块和参数写法。 原始讨论提交于 2026-08-17，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 贡献者…

2 分钟阅读
故障排查GitHub Issue

FastGPT文档解析功能的API调用与自定义实现方案

FastGPT文档解析功能的API调用与自定义实现方案 现象 用户需要在FastGPT中实现聊天时上传文档，将文档作为上下文进行问答，因此需要文档解析功能支持传入文档并直接返回解析后的数据，或获取可行的实现方案。 可能原因 官方镜像未提供直接可用的文档解析API，需通过源码改动后打包实现。现有第三方解析库存…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT处理文档时的解析异常与块关联问题

解决FastGPT处理文档时的解析异常与块关联问题 现象 上传word文档并拆块后，部分层级标题未涵盖对应子层内容；单表excel文件拆块后，块与块之间无关联；pdf文档解析后标题层级关系不明确，整体解析质量待提升。处理过程中需优先保障输入文本的质量，以保障最终输出效果。 可能原因 暂无明确已知根因，需结合…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT上传docx后分段留存内容数量异常的问题

解决FastGPT上传docx后分段留存内容数量异常的问题 现象 上传docx格式文件时，文件内包含40条内容，经FastGPT直接分段处理后，仅留存21条内容。 可能原因 直接分段的处理逻辑未匹配用户定义的“40条内容”拆分标准，且该逻辑本身不关注文件内的内容条目数量。需按实际环境确认是否存在其他未提及的…

2 分钟阅读
故障排查GitHub Issue

FastGPT中动态加载MCP服务工具到下拉框的实现方法

FastGPT中动态加载MCP服务工具到下拉框的实现方法 现象 用户需要在FastGPT中通过点击按钮，将自定义编写的Python MCP服务的工具动态加载至下拉选择框，当前不清楚该动态加载功能的具体实现方式。 可能原因 未明确FastGPT调用外部自定义MCP服务的交互方式，且不清楚如何将服务返回的工具数…

2 分钟阅读