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

FastGPT聊天时动态指定模型名称的排查与解决方法

FastGPT聊天时动态指定模型名称的排查与解决方法 现象 在FastGPT聊天场景中，无法通过界面按钮动态指定使用的模型名称，仅能提前在工作流中写死模型参数。同一厂商的模型虽可切换，但无专属设置按钮，无法由用户在会话过程中自主选择模型，无法实现仅通过单个AI会话节点完成多模型切换的需求。 可能原因 当前系…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT早期Office文件无法正常解析的问题

解决FastGPT早期Office文件无法正常解析的问题 现象 FastGPT 4.8.9及后续版本支持文件上传功能，但原生仅支持解析.txt, .docx, .csv, .xlsx, .pdf, .md, .html, .pptx格式文件。使用xls、doc、ppt等早期Office格式文件时，无法直接完…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT社区版与商业版功能差异及选型问题

解决FastGPT社区版与商业版功能差异及选型问题 现象 用户在使用FastGPT社区版过程中，对社区版与商业版的功能边界存在疑问，或在技术选型时无法明确两者的适配场景。 可能原因 社区版与商业版的功能差异仅集中在少数模块，且相关差异说明未清晰呈现，导致用户难以快速区分两者的适配场景。 排查步骤 1. 确认…

1 分钟阅读