故障排查GitHub Issue
解决FastGPT私有部署版MCP工具无搜索条件不显示的问题
解决FastGPT私有部署版MCP工具无搜索条件不显示的问题 现象 FastGPT私有部署版的应用列表页面中，不添加任何查询条件时，列表无法展示MCP工具。在搜索框输入查询条件后，列表可正常展示MCP应用。此外用户反馈MCP工具当前置于应用模块，存在使用逻辑不合理的问题。 可能原因 当前公开信息未明确该现象…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT中MCP工具集URL替换后工具路径未刷新的问题
解决FastGPT中MCP工具集URL替换后工具路径未刷新的问题 现象 在FastGPT v4.9.14私有部署版本中，对已创建的MCP工具集替换为新的MCP SERVER URL后，工具集列表内的工具请求路径未同步刷新。此时单独调用该工具集内的任意工具，会返回404错误。 可能原因 替换MCP工具集URL…
故障排查GitHub Issue
解决FastGPT工作流中MCP工具无限重复循环的问题
解决FastGPT工作流中MCP工具无限重复循环的问题 现象 MCP工具在FastGPT简易应用中可正常运行，在私有部署版本的工作流中使用时，出现无限重复循环的问题。该问题的复现步骤为在工作流中添加MCP测试工具，相关异常状态有对应的系统日志与截图记录。 可能原因 目前无明确已知触发逻辑，需结合实际部署环境…
故障排查GitHub Issue
解决FastGPT中Milvus与MongoDB向量ID不匹配问题
解决FastGPT中Milvus与MongoDB向量ID不匹配问题 现象 FastGPT私有部署4.8.10版本运行过程中，出现Milvus向量数据库存储的向量ID与MongoDB数据库中对应业务文档的ID不一致的情况，该问题可通过对应数据库的查询界面查看具体数据差异。 可能原因 目前未明确该问题的直接触发…
故障排查GitHub Issue
解决FastGPT设置最低相关度过滤后引用未被过滤的问题
解决FastGPT设置最低相关度过滤后引用未被过滤的问题 现象 FastGPT私有部署版本v4.8.15中，设置知识库最低相关度过滤阈值后，配置的过滤规则未生效，不符合预期的引用信息未被过滤掉，与设置的过滤要求不符，该问题附带了相关配置截图佐证。 可能原因 当前公开信息未明确该问题的具体触发根源，需结合实际…
故障排查GitHub Issue
解决FastGPT调用MinerU API报错422及适配镜像构建问题
解决FastGPT调用MinerU API报错422及适配镜像构建问题 现象 使用私有部署v4.14.6版本的FastGPT，调用本地部署的MinerU API时，返回报错Request failed with status code 422。用户需要基于最新版本的MinerU构建适配FastGPT的镜像，…
故障排查GitHub Issue
解决FastGPT中fastgpt-minio域名解析报错问题
解决FastGPT中fastgpt-minio域名解析报错问题 现象 系统触发意外错误，日志记录报错内容为[Error] 2025-12-24 16:28:28 System unexpected error: /api/core/dataset/file/getPreviewChunks, getaddr…
故障排查GitHub Issue
FastGPT私有部署镜像被扫描为挖矿程序的排查与解决
FastGPT私有部署镜像被扫描为挖矿程序的排查与解决 现象 在阿里云ECS环境中，部署registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.8.12镜像时，安全扫描工具识别该镜像包含挖矿程序。 可能原因 目前无FastGPT官方的明确说明，可能为安全扫描…
故障排查GitHub Issue
FastGPT参数输入缺失问题的排查与解决方法
FastGPT参数输入缺失问题的排查与解决方法 现象 使用FastGPT v4.8 docker部署版本时，出现参数输入缺失的问题，界面中相关参数输入项未正常显示或无法完成输入操作。 可能原因 需按实际部署环境确认，暂无可直接匹配的通用已知原因。 排查步骤 1. 确认当前使用的FastGPT版本为v4.8…
故障排查GitHub Issue
FastGPT混合检索加重排序排名与语义分数异常排查指南
FastGPT混合检索加重排序排名与语义分数异常排查指南 现象 在FastGPT 4.8.1私有部署版本的检索召回流程中，使用混合检索搭配重排序功能时，重排序排名第一的段落综合排名未达到预期高度，且未显示语义排序相关的分数信息。 可能原因 该异常暂无明确预设关联原因，需结合实际部署配置、运行日志与功能调用链…
故障排查GitHub Issue
解决FastGPT私有部署版混合检索无返回问题
解决FastGPT私有部署版混合检索无返回问题 现象 使用FastGPT 4.7.1私有部署版本时，AI对话搭配知识库引用功能中，语义检索模式可正常返回匹配的知识库结果，混合检索模式无任何返回结果。相关场景与配置情况通过两张截图展示。 可能原因 当前无明确关联的已知根原因，无法直接定位问题来源，需结合实际部…
故障排查GitHub Issue
解决FastGPT移动端AI回答图片无法手势放大的问题
解决FastGPT移动端AI回答图片无法手势放大的问题 现象 FastGPT的AI回答包含图片时，移动端点击图片无法通过手势放大，PC端可使用滚轮放大图片。 可能原因 无公开明确的已知触发原因，需结合实际部署环境与代码逻辑排查。 排查步骤 1. 确认FastGPT已升级至最新版本。 2. 在移动端打开Fas…