故障排查GitHub Issue
FastGPT MongoDB目录大量数据文件清理与排查方法
FastGPT MongoDB目录大量数据文件清理与排查方法 现象 用户在FastGPT部署环境中，发现MongoDB的数据目录下存在大量数据文件，需明确文件相关信息并完成清理操作。 可能原因 MongoDB会存储FastGPT运行产生的各类业务数据，随着系统运行时长增加、业务交互累积，数据会持续写入存储目…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT新增渠道时未添加模型无法搜索的问题
解决FastGPT新增渠道时未添加模型无法搜索的问题 现象 在FastGPT的「模型渠道 新增渠道」页面，未添加模型时无法使用模型搜索功能，仅能展示全量未筛选的模型列表，需向下滚动页面手动查找目标模型，操作流程较长。 可能原因 该页面的模型搜索功能与渠道已添加的模型配置绑定，未加入模型时搜索功能无法正常触发…
故障排查GitHub Issue
解决FastGPT开启模型思考模式后无思考过程输出的问题
解决FastGPT开启模型思考模式后无思考过程输出的问题 现象 用户在FastGPT 4.14.10私有部署版本中，已在模型配置页面开启思考模式，但在发起问答交互时，未输出对应的思考过程内容。 可能原因 由于本次issue未披露更多异常细节，可能的关联因素需结合实际部署环境确认，例如模型配置的思考模式参数未…
故障排查GitHub Issue
解决FastGPT 4.15版本OpenSandbox部署复杂的问题
解决FastGPT 4.15版本OpenSandbox部署复杂的问题 现象 用户在使用FastGPT 4.15版本时，遇到OpenSandbox、fastgpt-agent-sandbox-proxy相关部署流程复杂的问题，花费较长时间仍无法顺利完成部署；同时配套官方文档存在前后描述不一致、字段名称不统一的…
故障排查GitHub Issue
解决FastGPT免登与门户集成的身份体系不统一问题
解决FastGPT免登与门户集成的身份体系不统一问题 现象 在FastGPT私有部署v4.15.1版本中，免登录身份验证流程会从身份服务器获取uid并将其作为智能体对话的用户id参数。当FastGPT与本地门户集成后，门户创建的账户uid由FastGPT自动生成，导致两条链路的用户身份体系相互独立。同一名自…
故障排查GitHub Issue
解决FastGPT私有部署中$开头MCP工具的存储报错问题
解决FastGPT私有部署中$开头MCP工具的存储报错问题 现象 FastGPT私有部署版本4.15.6中，因部署环境CPU不支持AVX指令集，使用了mongo:4.4.30作为MongoDB镜像。当存在名称以$开头的MCP工具时，单击保存按钮会触发MongoDB存储相关报错，无法完成工具保存。 可能原因…
故障排查GitHub Issue
解决FastGPT私有部署中知识库图片无法正常输出的问题
解决FastGPT私有部署中知识库图片无法正常输出的问题 现象 用户在私有部署V4.14.2版本的FastGPT中，使用知识库作为业务客服辅助工具，上传带图片的Word文档后，在AI对话中引导模型输出图片时，图片无法正常展示。尝试开启或关闭“图片转64位”功能，未对图片展示效果产生影响。日志显示异常图片链接…
故障排查GitHub Issue
FastGPT私有部署微信渠道无回复的排错步骤
FastGPT私有部署微信渠道无回复的排错步骤 现象 用户部署FastGPT V4.14.26私有版本时，agent网页对话功能正常，但个人微信渠道出现异常：扫码绑定后页面显示"渠道从未使用"，微信客户端提示无法连接。经测试，容器内可正常连接微信服务器，但发送消息后，app容器的debug日志无任何输出。…
故障排查GitHub Issue
解决FastGPT调用指定短视频创作提示词的输出异常问题
解决FastGPT调用指定短视频创作提示词的输出异常问题 现象 未从提供的语料中获取明确的报错信息或具体异常表现。若实际使用中出现输出未遵循指定结构化格式、风格不符、内容缺失等情况，均需按对应场景记录具体表现。 可能原因 未从提供的语料中获取具体的错误触发条件、配置参数等信息。常见可能方向包括提示词配置偏差…
故障排查GitHub Issue
解决FastGPT pushData接口返回无dataId字段无法定位数据的问题
解决FastGPT pushData接口返回无dataId字段无法定位数据的问题 现象 调用FastGPT的/api/core/dataset/data/pushData接口创建训练数据推送任务时，接口返回结果仅包含insertLen统计字段，未返回dataId、q、a等单条数据的标识与内容字段。例如本次请…
故障排查GitHub Issue
FastGPT中qwen3.5-omni全模态模型的排错方法
FastGPT中qwen3.5-omni全模态模型的排错方法 现象 用户在FastGPT中配置或调用qwen3.5-omni全模态模型时，出现无法正常调用、无响应或报错的情况，具体报错信息需按实际环境确认。 可能原因 1. 当前使用的FastGPT版本未集成qwen3.5-omni全模态模型的适配配置； 2…
故障排查GitHub Issue
解决FastGPT去除公网域名与IP依赖的相关问题
解决FastGPT去除公网域名与IP依赖的相关问题 现象 当前使用FastGPT时，无论是部署初始化还是运行对话、知识库调用等核心功能，都必须依赖公网域名或IP地址，无法在仅具备内网访问权限的环境中完成正常使用，无法满足离线部署的需求。 可能原因 由于该需求为用户提交的功能改进请求，官方暂未公开具体的技术限…