故障排查GitHub Issue
解决FastGPT私有部署时MongoDB访问被拒无法启动的问题
解决FastGPT私有部署时MongoDB访问被拒无法启动的问题 现象 用户在Win10系统（Docker Desktop v4.30.0）中，使用最新版FastGPT的docker-compose.yml文件，将镜像源替换为阿里云后，修改了PG的权限配置，执行docker compose up -d启动容…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT私有部署版工作流嵌套选择操作无回复问题
解决FastGPT私有部署版工作流嵌套选择操作无回复问题 现象 私有部署版本4.8.22的FastGPT中，封装了用户确认选择操作的工作流，无法通过嵌套调用的方式在其他工作流中正常输出指定回复内容。具体表现为：在单个工作流内测试用户选择操作时，可正常输出预设的指定回复；但将该工作流嵌套至另一个工作流后，点击…
故障排查GitHub Issue
解决FastGPT私有部署版Ollama工具调用失败问题
解决FastGPT私有部署版Ollama工具调用失败问题 现象 用户使用FastGPT 4.8.17私有部署版，搭配Ollama 0.5.4、OneAPI 0.6.7部署Qwen2.5:14b模型后，通过curl直接调用OneAPI的工具接口无报错，但在FastGPT工作流中无法正常使用工具调用。用户提供了…
故障排查GitHub Issue
解决FastGPT私有部署中Ollama模型调用失败问题
解决FastGPT私有部署中Ollama模型调用失败问题 现象 用户在Macbook Pro M4 Max 128G设备上完成Docker、Ollama、FastGPT及OneAPI的私有部署。Ollama已下载DeepSeek R1-32B和bge-m3 embedding模型，本地模型测试运行成功，Fa…
故障排查GitHub Issue
解决FastGPT 4.8.5封装插件内AI对话输出杂乱的问题
解决FastGPT 4.8.5封装插件内AI对话输出杂乱的问题 现象 用户使用私有部署4.8.5版本的FastGPT时，调用自定义封装插件后，项目返回的AI对话内容杂乱无章。回溯插件内的完整AI对话输出时，内容显示正常；插件输出的自定义变量内容也无异常。相关截图显示项目返回的内容与插件内的完整输出存在明显差…
故障排查GitHub Issue
私有部署FastGPT无法识别插件与获取插件效果的排错方法
私有部署FastGPT无法识别插件与获取插件效果的排错方法 现象 用户通过docker-compose方式私有部署FastGPT，使用qwen2:1.5b模型时，出现无法识别插件、无法获取插件效果的问题。该功能在线上版本可正常使用，私有部署版本存在异常。 可能原因 目前无明确的已知根因，需结合私有部署的实际…
故障排查GitHub Issue
解决FastGPT私有部署版向量召回失效问题的排错方法
解决FastGPT私有部署版向量召回失效问题的排错方法 现象 用户在FastGPT 4.9.0及以后的私有部署版本中，使用RAG进行问答时，部分低频问题无法被向量召回。当短问题与大量长文本共同参与筛选时，即使与目标文本的向量相似度达到100%，也无法召回该目标文本。通过FastGPT控制台获取PGvecto…
故障排查GitHub Issue
FastGPT私有部署版重排模型调用时机异常排错指南
FastGPT私有部署版重排模型调用时机异常排错指南 现象 用户使用Docker部署bge-rerank-v2-m3重排模型，在FastGPT私有部署4.8.10版本中出现调用异常：部分场景下重排模型会在AI对话结束后才执行调用，导致重排失败；闲置5分钟后再次发起对话，重排模型可恢复正常调用。从提供的日志可…
故障排查GitHub Issue
解决FastGPT私有部署向量检索结果分数值一致问题
解决FastGPT私有部署向量检索结果分数值一致问题 现象 使用V4.8.5私有部署版本的FastGPT，搭配bge-m3或m3e-large向量模型进行向量检索时，所有返回结果的分数值完全一致，无法正常使用搜索结果。 可能原因 暂未明确该问题的具体触发原因，需结合实际部署环境逐步排查。该问题同时出现在bg…
故障排查GitHub Issue
解决FastGPT私有部署多文件上传时临时文件丢失的问题
解决FastGPT私有部署多文件上传时临时文件丢失的问题 现象 私有部署版本4.8.21的FastGPT中，同时上传多个文件时，调用/v1/parse/file接口会返回500 Internal Server Error。报错日志显示FileNotFoundError: /root/temp/file.pd…
故障排查GitHub Issue
解决FastGPT私有部署升级后的数据库与配置报错
解决FastGPT私有部署升级后的数据库与配置报错 现象 私有部署FastGPT完成升级后，出现三类报错信息：一是启动时提示ENOENT: no such file or directory, open '/app/data/config.json'；二是初始化PostgreSQL时提示access met…
故障排查GitHub Issue
解决FastGPT 4.7.1私有部署版语音输入与播报失效问题
解决FastGPT 4.7.1私有部署版语音输入与播报失效问题 现象 用户使用FastGPT 4.7.1私有部署版本，已成功接入OpenAI模型、tts-1和whisper-1渠道并通过渠道测试。出现两处功能异常：1. 点击语音输入按钮无任何响应；2. 语音播报功能无法进行试听。 可能原因 结合已知信息，可…