故障排查GitHub Issue
解决FastGPT中Milvus与MongoDB向量ID不匹配问题
解决FastGPT中Milvus与MongoDB向量ID不匹配问题 现象 FastGPT私有部署4.8.10版本运行过程中，出现Milvus向量数据库存储的向量ID与MongoDB数据库中对应业务文档的ID不一致的情况，该问题可通过对应数据库的查询界面查看具体数据差异。 可能原因 目前未明确该问题的直接触发…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查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…
故障排查GitHub Issue
解决FastGPT私有部署版移动端Markdown导出异常问题
解决FastGPT私有部署版移动端Markdown导出异常问题 现象 FastGPT私有部署版本4.8.20-fix2中，移动端完成对话后，点击"Markdown导出"功能，无法正常生成chat.md聊天记录文件，无法实现与Web端一致的导出效果。 可能原因 未明确具体技术成因，仅知问题出在移动端场景下的导…
故障排查GitHub Issue
FastGPT移动端语音输入交互体验优化排错指南
FastGPT移动端语音输入交互体验优化排错指南 现象 当前FastGPT移动端语音输入功能存在操作流程繁琐的问题，无法实现长按录音、松开自动发送的交互模式，且无法在语音输入过程中展示实时转写的文本内容，无法满足高效语音输入的使用需求。 可能原因 当前FastGPT移动端语音输入的交互逻辑未实现长按触发录音…
故障排查GitHub Issue
解决FastGPT新增模型未自动关联至对应渠道的问题
解决FastGPT新增模型未自动关联至对应渠道的问题 现象 在FastGPT渠道配置页面执行新增模型操作后，新增模型未自动关联至目标渠道，而是作为独立模型存在，无法通过对应渠道直接调用该新增模型。 可能原因 需按实际环境确认，无明确预设原因，需结合操作流程与系统状态排查。 排查步骤 1. 确认新增模型的操作…