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

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

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

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

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

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

阅读 API 指南 查看官方文档

按任务找到答案

共 4244 篇

故障排查GitHub Issue

解决FastGPT启动时提示找不到pluginTemplates目录的错误

解决FastGPT启动时提示找不到pluginTemplates目录的错误 现象 启动FastGPT时触发初始化系统错误，完整报错信息如下： 报错核心信息为：系统无法执行scandir操作，目标路径/app/data/pluginTemplates不存在，错误码为ENOENT，errno为-2。 可能原因…

4 分钟阅读
故障排查GitHub Issue

解决FastGPT中模型思考过程无法正常输出的问题

解决FastGPT中模型思考过程无法正常输出的问题 现象 用户在FastGPT 4.8.22私有部署版本中调用模型时，前端页面处于空白等待状态且等待时间较长。实际模型已执行思考流程，但FastGPT未正常输出模型的思考过程，与直接使用该模型时的表现存在差异。 可能原因 需结合实际部署环境确认，常见关联方向包…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT混合搜索开启结果重排时的rerank报错问题

解决FastGPT混合搜索开启结果重排时的rerank报错问题 现象 在FastGPT知识库搜索测试时，选择混合搜索+结果重排并执行搜索后，docker logs fastgpt返回如下报错信息：rerank error: { message: 'invalid request: list of docum…

2 分钟阅读
故障排查GitHub Issue

FastGPT手机模式点击应用顶部名称跳转首页的排错指南

FastGPT手机模式点击应用顶部名称跳转首页的排错指南 现象 将FastGPT应用通过脚本注入网页，或直接打开FastGPT应用时，当页面触发手机响应式模式，点击页面顶部的应用名称，会跳转至系统首页。该行为在对外发布的应用场景中不符合预期，用户预期点击后无任何跳转动作。 可能原因 目前未在该issue中明…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT调用通义千问系列及其他模型异常的问题

解决FastGPT调用通义千问系列及其他模型异常的问题 现象 用户在私有部署的FastGPT 4.8.11-fix版本中，搭配ollama 0.3.13与oneapi 0.6.8使用时，调用qwen2:7b、qwen2:1.5b、qwen2.5:7b、qwen2.5:3b、qwen2.5:1.5b以及gem…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT返回模型渠道无可用的错误响应格式问题

解决FastGPT返回模型渠道无可用的错误响应格式问题 现象 使用FastGPT私有部署v4.5.0版本时，会出现两类异常返回：第一类为模型调用错误，返回内容为{"code":500,"statusText":"","message":"当前分组 default 下对于模型 M3E 无可用渠道 (reque…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT新增模型渠道提示model config not found的问题

解决FastGPT新增模型渠道提示model config not found的问题 现象 部署环境为FastGPT v4.9.14（Docker Compose部署）、aiproxy v0.1.7时，出现以下问题： 1. 在FastGPT前端“模型提供商”→“模型渠道”页面新增任意模型渠道（如gpt-3.…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版模型配置异常的排查方法

解决FastGPT私有部署版模型配置异常的排查方法 现象 用户使用FastGPT V4.8.9私有部署版本，将OneAPI配置的百度模型作为知识库导入文件的向量模型与应用对话模型。对话测试时，系统提示GPT-4o模型不可使用，同时知识库的文件处理模型设置页面仅保留原有配置，无自定义修改入口。 可能原因 该问…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT测试模型配置时出现连接错误的问题

解决FastGPT测试模型配置时出现连接错误的问题 现象 用户在私有部署的FastGPT v4.9.0-fix2版本中，通过OneAPI配置好模型后，在FastGPT模型配置页面新建语言模型，选择“其他”作为模型提供商，填写模型ID为gpt-4o-2024-05-13，留空URL与访问密钥，点击测试时触发连…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT配置模型额外参数后返回结果为空的问题

解决FastGPT配置模型额外参数后返回结果为空的问题 现象 在FastGPT私有部署v4.12.3版本中，用户为模型配置额外参数{"format": "json"}，模型服务的运行日志显示该参数已正常生效，但FastGPT界面提示返回结果为空。直接通过脚本调用对应模型接口时，可以正常获取返回结果。 可能原…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中外层模型与底层元数据模型不独立的问题

解决FastGPT中外层模型与底层元数据模型不独立的问题 现象 私有部署版本FastGPT v4.8.20-fix2中，用户反馈出现外层模型与底层元数据关联的模型无法保持独立的问题，具体表现为外层model的参数或配置变更后，底层metadata.model的关联配置同步发生变化，与用户期望的独立效果不符，…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署中自定义模型调用端口未更新的问题

解决FastGPT私有部署中自定义模型调用端口未更新的问题 现象 在FastGPT V4.9.1私有部署版本中，用户成功部署bge-m3、bge-reranker-large模型，且通过模型渠道添加配置正常，但点击模型测试时出现报错。其中bge-reranker-large的配置端口已更新为8090，但实际…

2 分钟阅读