故障排查GitHub Issue
解决FastGPT私有部署中Ollama模型调用失败问题
解决FastGPT私有部署中Ollama模型调用失败问题 现象 用户在Macbook Pro M4 Max 128G设备上完成Docker、Ollama、FastGPT及OneAPI的私有部署。Ollama已下载DeepSeek R1-32B和bge-m3 embedding模型，本地模型测试运行成功，Fa…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查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. 语音播报功能无法进行试听。 可能原因 结合已知信息，可…
故障排查GitHub Issue
解决FastGPT私有部署4.8.20版本文心一言渠道测试失败问题
解决FastGPT私有部署4.8.20版本文心一言渠道测试失败问题 现象 用户使用FastGPT私有部署4.8.20版本，已开通文心一言账号并在OneAPI中配置对应渠道，且OneAPI内的渠道测试请求正常，但在FastGPT系统中启动该模型进行测试时，系统显示测试失败。 可能原因 结合该场景，可能的原因包…
故障排查GitHub Issue
解决FastGPT 4.7.1私有部署WSL环境数据卷丢失问题
解决FastGPT 4.7.1私有部署WSL环境数据卷丢失问题 现象 在FastGPT 4.7.1私有部署场景中，当Docker默认以WSL作为启动引擎时，容器的数据卷无法正常加载，会出现知识库和应用设置丢失的问题。仅通过改用PowerShell启动Docker并重新加载docker compose.yml…
故障排查GitHub Issue
排查FastGPT私有部署zilliz版连接Zilliz与Redis失败的相关问题
排查FastGPT私有部署zilliz版连接Zilliz与Redis失败的相关问题 现象 部署FastGPT 4.9.6私有部署zilliz版时，会出现两类连接失败问题： 1. 连接Zilliz服务器失败，页面无法正常使用相关依赖服务。 2. 连接Redis失败，报错文本为Redis connection…