故障排查GitHub Issue
解决FastGPT基于Vercel部署的数据库选型问题
解决FastGPT基于Vercel部署的数据库选型问题 现象 用户尝试在Vercel部署基于Next.js的FastGPT，需规划数据存储方案，同时考虑是否将现有MongoDB数据库与PostgreSQL合并，且发现知识库数据使用PostgreSQL。 可能原因 1. 对FastGPT的数据库选型规则不明确…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
FastGPT调用视觉模型发送图片返回503的排错方案
FastGPT调用视觉模型发送图片返回503的排错方案 现象 使用视觉模型时，发送文字请求可正常执行，发送图片请求返回503错误。端口未被屏蔽，同业务场景下其他工具可正常处理图片请求。 可能原因 存在两种可能的触发原因。其一，内部自身请求不被允许，导致图片转base64失败。其二，旧版本使用localhos…
故障排查GitHub Issue
解决FastGPT无法原生接入vllm部署模型的问题
解决FastGPT无法原生接入vllm部署模型的问题 现象 在FastGPT中使用vllm部署的模型时，无法直接原生接入，需借助第三方工具完成接入。 可能原因 vllm部署的模型兼容OpenAI格式，但多模型部署时需使用独立端口；FastGPT原生模型配置需手动调整自定义地址，未直接内置vllm的快速接入流…
故障排查GitHub Issue
解决FastGPT中vllm加载模型时不显示思考过程的问题
解决FastGPT中vllm加载模型时不显示思考过程的问题 现象 使用FastGPT 4.8.20版本，通过vllm-v0.7.1加载deepseek-r1-qwen-1.5b模型时，接口返回结果包含reasoningcontent字段，但对话界面仅展示content字段的内容，未显示思考过程。部分部署场景…
故障排查GitHub Issue
解决FastGPT使用vllm时工具调用参数解析错误问题
解决FastGPT使用vllm时工具调用参数解析错误问题 现象 当使用FastGPT调用相关服务时，生成的toolcalls结构中，function.arguments字段的值为空字符串""，将该内容传递给vllm时会触发解析错误。若将该字段设置为标准格式的"{}"，则解析流程可正常完成。 可能原因 该错误…
故障排查GitHub Issue
排查并解决FastGPT启用语音功能时的API异常问题
排查并解决FastGPT启用语音功能时的API异常问题 现象 用户尝试启用FastGPT的语音功能，已完成相关语音模型的添加操作，具体涉及whisper-1和tts-1模型，但在启用过程中遇到异常问题，无法正常使用语音功能。 可能原因 核心原因为API配置存在异常，相关密钥或接口设置不符合要求，导致语音功能…
故障排查GitHub Issue
修复FastGPT上传文件后语音输入按钮被隐藏的问题
修复FastGPT上传文件后语音输入按钮被隐藏的问题 现象 在FastGPT的聊天框中完成文件上传后，语音输入按钮被隐藏，无法使用语音对话功能，与预期支持上传文件后使用语音对话的需求不符。 可能原因 当前代码逻辑中，语音输入按钮的显示条件包含!havInput状态判断。当上传文件后，该状态发生变更，导致按钮…
故障排查GitHub Issue
FastGPT v4.7.1语音输入功能无响应的排查与解决指南
FastGPT v4.7.1语音输入功能无响应的排查与解决指南 现象 v4.7.1版本源码部署后，进入聊天页面点击语音输入按钮无反应，无法将语音转换为文本。部分用户调整后按钮可点击，但无波形显示，仍无法完成语音输入。 可能原因 1. 部署环境未启用HTTPS协议； 2. 未配置支持语音识别的模型（如whis…
故障排查GitHub Issue
FastGPT 语音播报开关与音色变量的历史需求
FastGPT 语音播报开关与音色变量的历史需求 适用场景与历史记录 原议题希望在工作流中根据用户选择开启语音播报并切换 TTS 音色，例如角色扮演中的角色声音。 原始讨论提交于 2025-03-01，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 当前应用配置中可见播报方式、模型和音色字段；这…
故障排查GitHub Issue
解决VS Code中FastGPT调试配置启动异常的问题
解决VS Code中FastGPT调试配置启动异常的问题 现象 使用该VS Code Node调试配置启动FastGPT相关调试时，出现启动失败或文件找不到、命令执行异常等问题。配置包含type为node，runtimeExecutable为pnpm，program指向${workspaceFolder}/…
故障排查GitHub Issue
FastGPT v4.8.22 移动端分享页首次白屏的历史排查
FastGPT v4.8.22 移动端分享页首次白屏的历史排查 适用场景与历史记录 原报告勾选公有云，描述 v4.8.22 网页渠道应用在移动端首次打开长时间白屏，重开浏览器后有时可进入。 原始讨论提交于 2025-02-23，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 原线程缺少根因与修复…
故障排查GitHub Issue
FastGPT开源版Web站点同步功能仅商业版可用的排查指南
FastGPT开源版Web站点同步功能仅商业版可用的排查指南 现象 Web站点同步功能仅商业版可用，开源版无法使用，该功能为业务刚需。 可能原因 FastGPT开源版本未包含Web站点同步功能，相关功能的开源版开放计划未公开。 排查步骤 1. 确认当前使用的FastGPT版本类型，区分商业版与开源版。 2.…