跳至主要内容
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配置Milvus地址后出现连接报错的问题

解决FastGPT配置Milvus地址后出现连接报错的问题 现象 在docker-compose环境中配置MILVUSADDRESS环境变量后，出现报错信息"Client must be connected before running operations"。所配置的MILVUSADDRESS为自行提前部…

2 分钟阅读
故障排查GitHub Issue

FastGPT连接Milvus向量库失败的排查与解决方法

FastGPT连接Milvus向量库失败的排查与解决方法 现象 FastGPT在docker-compose环境中配置Milvus向量库连接后出现报错，本地Milvus服务本身可正常使用且外部可直接操作。注销Milvus连接配置后Mongo连接恢复正常，启用Milvus连接后即出现报错。使用127.0.0.…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署时Milvus连接失败导致服务重启的问题

解决FastGPT私有部署时Milvus连接失败导致服务重启的问题 现象 使用docker-compose-milvus.yml部署FastGPT 4.8.22私有版本时，服务持续重启。查看服务日志可见初始化系统错误，具体报错为14 UNAVAILABLE: Name resolution failed f…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT接入MinerU后知识库文档解析超时问题

解决FastGPT接入MinerU后知识库文档解析超时问题 现象 接入MinerU实现知识库多格式文档解析时出现超时，前端提示错误。服务端日志显示解析耗时超过70秒。解析后的图片已存入MongoDB，images与datasetdatatexts表存在对应内容。涉及的文档格式包括pdf、pptx等。 可能原…

2 分钟阅读
故障排查GitHub Issue

说明FastGPT部署无需MinIO的配置方案

说明FastGPT部署无需MinIO的配置方案 现象 部署FastGPT时发现需依赖MinIO存储服务，无法直接沿用旧版无MinIO的部署方式，希望获取无需MinIO的部署配置。 可能原因 FastGPT新版本已转向S3存储相关逻辑，MinIO作为常用的S3兼容部署方案，成为默认依赖的存储服务，因此新版本部…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT同chatid多轮对话部分回复无日志记录问题

解决FastGPT同chatid多轮对话部分回复无日志记录问题 现象 FastGPT 4.9.14版本中，同一chatid下的多轮对话，某次AI回复在客户端正常展示，但控制台的【对话日志】无记录，通过MongoDB以text.content为关键字检索也无法找到该对话记录。 可能原因 暂未明确指向的已知原因…

2 分钟阅读
故障排查GitHub Issue

FastGPT 引用原文定位：历史需求与分块阅读器

FastGPT 引用原文定位：历史需求与分块阅读器 适用场景与历史记录 原议题于 2023 年请求从知识问答跳到文档中的具体位置，以查看出处上下文。 原始讨论提交于 2023-09-27，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 官方文档说明 4.9.1 引入分块阅读器，可打开原文并高亮引…

2 分钟阅读
故障排查GitHub Issue

FastGPT未提供具体信息的使用异常排查指引

FastGPT未提供具体信息的使用异常排查指引 现象 本次提交的FastGPT相关issue仅填写了例行检查勾选项，未提供具体的使用异常表现、复现流程、相关日志截图或配置文件等核心信息，无法直接定位具体问题。 可能原因 由于未明确具体异常场景、触发条件及报错信息，可能的问题原因需结合实际使用环境确认，无法直…

2 分钟阅读
故障排查GitHub Issue

FastGPT 复杂工作流持续加载的历史问题报告

FastGPT 复杂工作流持续加载的历史问题报告 适用场景与历史记录 原议题标题描述复杂工作流似乎持续加载，报告者填写的私有部署版本为 4.19.3，正文包含截图。 原始讨论提交于 2025-06-18，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 4.19.3 属于原作者自报信息，准确版本仍…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT缺失ReRankModels配置导致初始化失败问题

解决FastGPT缺失ReRankModels配置导致初始化失败问题 现象 FastGPT部署后出现拉取初始化数据失败的问题，该问题可出现于公有云版本或私有部署版本中。 可能原因 配置文件中缺少ReRankModels配置项，系统未对该配置项做判空处理，导致初始化流程无法正常执行。 排查步骤 1. 查看当前…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT混合检索模式下知识库分类命中偏差问题

解决FastGPT混合检索模式下知识库分类命中偏差问题 现象 知识库内一般命令为1-20条，较重命令为21-41条，严重命令为42-50条。使用FastGPT混合检索模式时，提问"一般命令有哪些"，预期返回1-20条一般命令内容，实际返回严重或较重违规的答案。单独使用语义检索可检索到"一般XX"相关内容，但…

2 分钟阅读