故障排查GitHub Issue
排查并解决FastGPT对话日志无API接口调用日志的问题
排查并解决FastGPT对话日志无API接口调用日志的问题 现象 FastGPT 4.8.16、4.8.17版本中，对话日志页面未显示API接口调用日志，提交issue时附带两张未展示相关日志的截图。 可能原因 仅当API请求携带chatid参数时，才会生成对应的接口调用日志。未生成日志的可能原因为API请…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
FastGPT私有部署版对话文本输出速度不稳定的排查与解决方法
FastGPT私有部署版对话文本输出速度不稳定的排查与解决方法 现象 在FastGPT私有部署版本4.8.11中进行AI对话后，对话框内输出的文字速度有时快有时慢，该问题仅影响文本输出环节。 可能原因 该问题通常与所使用API密钥对应的服务端数据返回速度有关，未发现其他明确关联因素。 排查步骤 1. 打开浏…
故障排查GitHub Issue
FastGPT直接选择文件上传失败的排查与解决方法
FastGPT直接选择文件上传失败的排查与解决方法 现象 在FastGPT的对话交互界面中，直接通过文件选择按钮上传文件时操作失败，将目标文件粘贴至输入框后可正常完成上传流程。 可能原因 目前未明确具体根因，仅观察到直接选择文件与粘贴文件到输入框两种上传方式的行为存在明确差异，直接选择文件的上传流程存在异常…
故障排查GitHub Issue
配置FastGPT实现高相似度问答直接返回知识库内容
配置FastGPT实现高相似度问答直接返回知识库内容 现象 用户希望在FastGPT中配置相似度阈值（如90%），当用户问题与知识库内容相似度超过阈值时，直接返回最高匹配的知识库QA内容并结束对话；未达阈值时使用AI对话加工结果。该需求用于接口调用场景，避免AI模型处理带来的延迟。用户尝试相关配置后，发现H…
故障排查GitHub Issue
解决FastGPT高级编排配置无历史记录不生效的问题
解决FastGPT高级编排配置无历史记录不生效的问题 现象 在FastGPT高级编排中配置历史记录为0后，页面测试无异常，但生成的外部分享链接仍携带聊天记录，后台"聊天"页面的配置也未生效，且未使用简易模式。 可能原因 仅设置历史记录数值为0未正确生效，或未正确移除历史记录相关模块。 排查步骤 1. 确认当…
故障排查GitHub Issue
FastGPT v4.9.7 上传 .doc 文件报错的历史排查
FastGPT v4.9.7 上传 .doc 文件报错的历史排查 适用场景与历史记录 原议题描述 v4.9.7 对话上传 .doc 文件报错，并询问该格式是否受支持。 原始讨论提交于 2025-05-06，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 原线程缺少可复制错误文本。旧版 .doc…
故障排查GitHub Issue
解决FastGPT无法将.doc格式文档上传至知识库的问题
解决FastGPT无法将.doc格式文档上传至知识库的问题 现象 在FastGPT的知识库文档上传流程中，可选的文档类型列表未包含.doc格式。用户在使用过程中发现，现有功能仅支持.docx等格式的文档导入，未提供.doc格式的导入选项。企业内部存在大量.doc格式文档的使用场景，现有功能无法满足该类文档的…
故障排查GitHub Issue
解决FastGPT Docker部署后的接口连接异常及403、429报错
解决FastGPT Docker部署后的接口连接异常及403、429报错 现象 Docker-compose部署FastGPT后，对话时显示接口连接异常。后续依次出现request failed with status code 403、429报错，部分场景提示密钥不合法，直接访问部署地址无法获取正常响应。…
故障排查GitHub Issue
解决FastGPT Docker镜像构建与版本更新异常问题
解决FastGPT Docker镜像构建与版本更新异常问题 现象 出现两类异常：其一，使用run.sh部署后仍为老版本，需邮件注册登录，无法使用新版直接root登录的功能，且无法使用高级编排功能；其二，执行docker build --build-arg name=app -t fastgpt:latest…
故障排查GitHub Issue
解决FastGPT Docker Compose部署的镜像与版本配置错误
解决FastGPT Docker Compose部署的镜像与版本配置错误 现象 使用Docker Compose部署FastGPT时，执行docker-compose up -d命令后出现报错：error pulling image configuration: Get https://production…
故障排查GitHub Issue
解决Docker部署FastGPT的扩展、HTTP调用与环境配置问题
解决Docker部署FastGPT的扩展、HTTP调用与环境配置问题 现象 使用Docker部署FastGPT后，无法修改源码，扩展能力受限。HTTP调用功能僵硬，无法灵活处理返回值，也无法定义变量以灵活访问HTTP接口。用户希望了解Docker部署FastGPT所需的环境安装包，以进行源码部署。 可能原因…
故障排查GitHub Issue
解决Docker部署FastGPT后无操作时硬盘高频写入的排查修复问题
解决Docker部署FastGPT后无操作时硬盘高频写入的排查修复问题 现象 在Docker环境中部署FastGPT并使用OB数据库时，无操作状态下硬盘出现高频写入，写入速度达40m/s，硬盘占用率达50%。该现象并非偶发，停止FastGPT项目后，硬盘写入量瞬间降至几十k每秒，占用率降至0-1%。另有排查…