跳至主要内容
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 pnpm dev启动时Mongo副本集事务相关报错

解决FastGPT pnpm dev启动时Mongo副本集事务相关报错 现象 执行pnpm dev命令启动FastGPT项目时，触发初始化根用户流程失败，抛出完整报错信息为init root user error MongoServerError: Transaction numbers are only…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署Mongo副本集初始化报错问题

解决FastGPT私有部署Mongo副本集初始化报错问题 现象 使用Docker Compose部署FastGPT私有部署版本4.6.8时，在教程第四步初始化Mongo副本集步骤中，执行指定的副本集初始化命令，终端提示报错文本"This node was not started with the replS…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署MongoDB绑定IP配置不生效问题

解决FastGPT私有部署MongoDB绑定IP配置不生效问题 现象 私有部署FastGPT时，修改mongod.comf.orig文件中的bindIp参数为0.0.0.0后，配置未生效，文件内原参数为127.0.0.1。 可能原因 未正确加载修改后的MongoDB配置文件，或配置修改未被MongoDB服务…

2 分钟阅读
故障排查GitHub Issue

调整FastGPT中MongoDB全文检索分词策略配置方法

调整FastGPT中MongoDB全文检索分词策略配置方法 现象 使用MongoDB作为全文检索存储介质搭建AI客服时，知识语料中的专有名词、型号被错误分词，导致专有名词的检索召回结果未达预期。 可能原因 MongoDB默认的全文检索分词策略未针对专有名词进行优化，无法完整保留专有名词的形态，进而影响专有名…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署MongoDB版本安全漏洞升级指导

FastGPT私有部署MongoDB版本安全漏洞升级指导 现象 当前FastGPT私有部署版本为4.8.13，环境中MongoDB版本为5.0.18，该版本被扫描出存在安全漏洞。官方默认搭载的MongoDB版本即为5.0.18，需确认自主升级的可行性及对FastGPT功能的影响。 可能原因 FastGPT私…

2 分钟阅读
故障排查GitHub Issue

FastGPT配置微软接口后语音播报相关问题排错指南

FastGPT配置微软接口后语音播报相关问题排错指南 现象 配置微软接口后，FastGPT语音播报不支持微软音色，无播音员下拉选择菜单，无法下载生成的音频文件。该问题影响语音播报、文字转语音等相关功能的正常使用。 可能原因 需按实际环境确认，包括微软语音接口的配置正确性、平台是否集成微软语音的音色选择与音频…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT多分支流程每次提问需重复选择分支的问题

解决FastGPT多分支流程每次提问需重复选择分支的问题 现象 当前FastGPT多分支流程的交互逻辑为每次用户发送提问后，均弹出分支选择界面，用户需重复选择对应分支。例如设置政府采购与招标投标两个分支流程时，用户单次选择分支后，后续发送的相关话题提问仍需再次选择分支，无法沿用首次选择的分支。 可能原因 当…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT多知识库调用时token超出模型上限问题

解决FastGPT多知识库调用时token超出模型上限问题 现象 使用FastGPT私有部署4.7.1版本，通过工具调用接入多个知识库，单个知识库引用上限设置低于3000 token。当调用2个知识库回答问题时，系统提示token超出模型16k上限，无法正常完成回答。 可能原因 具体原因需按实际环境确认。…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT多工具依赖调用时参数未正确替换的问题

解决FastGPT多工具依赖调用时参数未正确替换的问题 现象 私有部署版本4.12.3的FastGPT中，创建应用并配置自定义MCP Server，使用千问系列模型且functionCall设为false时，多工具依赖调用会出现回答中断的情况，工具参数未被正确替换。例如，调用查询本月最新文章的工具前，需先调…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT多轮AI聊天结果堆叠显示的问题

解决FastGPT多轮AI聊天结果堆叠显示的问题 现象 在使用FastGPT的多轮AI聊天功能时，所有AI回复结果挤在一起显示，未按照建议的方式分开呈现，也未仅展示最后一轮的AI回复结果。该问题导致多轮聊天的历史回复无法清晰区分，影响查看与使用体验。 可能原因 暂无明确的已知触发原因，无法直接确定具体诱因。…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署版多模态模型调用503报错排查

FastGPT私有部署版多模态模型调用503报错排查 现象 在FastGPT私有部署v4.81版本中，调用多模态模型MiniCPM-Llama3-V-25时，文字聊天流程可正常运行，开启视觉功能上传图片后，返回Service Unavailable 503报错。 可能原因 该报错通常关联模型服务配置、接口连…

2 分钟阅读