跳至主要内容
FASTGPT / 技术中心

从部署到 API，
直接找到可执行答案。

面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。

4316 篇内容11 个主题官方文档与公开 Issue
推荐入口
API官方文档3 分钟阅读

FastGPT对话接口API的调用方法与参数配置说明

可在应用详情的路径中获取AppId。鉴权使用APIKey，支持两种方式：调用 chat/completions 时在请求体传入 body.appId ，或通过 Authorization: Bearer apiKey - a…

阅读 API 指南 查看官方文档

按任务找到答案

共 4316 篇

故障排查GitHub Issue

解决FastGPT 4.15版本OpenSandbox部署复杂的问题

解决FastGPT 4.15版本OpenSandbox部署复杂的问题 现象 用户在使用FastGPT 4.15版本时，遇到OpenSandbox、fastgpt-agent-sandbox-proxy相关部署流程复杂的问题，花费较长时间仍无法顺利完成部署；同时配套官方文档存在前后描述不一致、字段名称不统一的…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT免登与门户集成的身份体系不统一问题

解决FastGPT免登与门户集成的身份体系不统一问题 现象 在FastGPT私有部署v4.15.1版本中，免登录身份验证流程会从身份服务器获取uid并将其作为智能体对话的用户id参数。当FastGPT与本地门户集成后，门户创建的账户uid由FastGPT自动生成，导致两条链路的用户身份体系相互独立。同一名自…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署中$开头MCP工具的存储报错问题

解决FastGPT私有部署中$开头MCP工具的存储报错问题 现象 FastGPT私有部署版本4.15.6中，因部署环境CPU不支持AVX指令集，使用了mongo:4.4.30作为MongoDB镜像。当存在名称以$开头的MCP工具时，单击保存按钮会触发MongoDB存储相关报错，无法完成工具保存。 可能原因…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署中知识库图片无法正常输出的问题

解决FastGPT私有部署中知识库图片无法正常输出的问题 现象 用户在私有部署V4.14.2版本的FastGPT中，使用知识库作为业务客服辅助工具，上传带图片的Word文档后，在AI对话中引导模型输出图片时，图片无法正常展示。尝试开启或关闭“图片转64位”功能，未对图片展示效果产生影响。日志显示异常图片链接…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署微信渠道无回复的排错步骤

FastGPT私有部署微信渠道无回复的排错步骤 现象 用户部署FastGPT V4.14.26私有版本时，agent网页对话功能正常，但个人微信渠道出现异常：扫码绑定后页面显示"渠道从未使用"，微信客户端提示无法连接。经测试，容器内可正常连接微信服务器，但发送消息后，app容器的debug日志无任何输出。…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT调用指定短视频创作提示词的输出异常问题

解决FastGPT调用指定短视频创作提示词的输出异常问题 现象 未从提供的语料中获取明确的报错信息或具体异常表现。若实际使用中出现输出未遵循指定结构化格式、风格不符、内容缺失等情况，均需按对应场景记录具体表现。 可能原因 未从提供的语料中获取具体的错误触发条件、配置参数等信息。常见可能方向包括提示词配置偏差…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT pushData接口返回无dataId字段无法定位数据的问题

解决FastGPT pushData接口返回无dataId字段无法定位数据的问题 现象 调用FastGPT的/api/core/dataset/data/pushData接口创建训练数据推送任务时，接口返回结果仅包含insertLen统计字段，未返回dataId、q、a等单条数据的标识与内容字段。例如本次请…

2 分钟阅读
故障排查GitHub Issue

FastGPT中qwen3.5-omni全模态模型的排错方法

FastGPT中qwen3.5-omni全模态模型的排错方法 现象 用户在FastGPT中配置或调用qwen3.5-omni全模态模型时，出现无法正常调用、无响应或报错的情况，具体报错信息需按实际环境确认。 可能原因 1. 当前使用的FastGPT版本未集成qwen3.5-omni全模态模型的适配配置； 2…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT去除公网域名与IP依赖的相关问题

解决FastGPT去除公网域名与IP依赖的相关问题 现象 当前使用FastGPT时，无论是部署初始化还是运行对话、知识库调用等核心功能，都必须依赖公网域名或IP地址，无法在仅具备内网访问权限的环境中完成正常使用，无法满足离线部署的需求。 可能原因 由于该需求为用户提交的功能改进请求，官方暂未公开具体的技术限…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署后重启丢失嵌入知识库数据问题

解决FastGPT私有部署后重启丢失嵌入知识库数据问题 现象 用户使用docker compose部署私有部署版本FastGPT，前端显示版本为4.14.20，fastgpt-app镜像版本为4.14.22，使用seekdb相关的compose文件。创建知识库并添加文件后，seekdb内可查询到嵌入数据，执…

2 分钟阅读
故障排查GitHub Issue

配置FastGPT沙箱代理后无法预览文档的排错方法

配置FastGPT沙箱代理后无法预览文档的排错方法 现象 用户配置了AGENTSANDBOXPROXYURL环境变量为ws://192.168.0.11:1006，确认该WebSocket代理地址可通过浏览器正常访问，同时配置了AGENTSANDBOXPREVIEWPROXYURL为http://192.1…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT沙箱提供商适配与扩展相关的排查问题

解决FastGPT沙箱提供商适配与扩展相关的排查问题 现象 当前FastGPT仅支持sealosdevbox和opensandbox两种沙箱提供商，用户无法直接调用e2b或UCloud沙箱服务，在需要扩展沙箱提供商适配时，无对应的配置或代码路径可供使用。 可能原因 FastGPT内置的沙箱适配模块仅集成了s…

2 分钟阅读