跳至主要内容
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私有部署中AI回复空行导致格式错位问题

解决FastGPT私有部署中AI回复空行导致格式错位问题 现象 该问题仅出现在私有部署版本的FastGPT中，AI生成的回复内容存在多余空行，导致最终展示的回复格式无法正常对齐，具体表现可通过对应界面截图确认。 可能原因 当前仅明确触发该问题的直接因素为AI回复中存在多余空行，具体触发空行生成的场景、与系统…

2 分钟阅读
故障排查GitHub Issue

修复FastGPT知识库搜索为空时的上下文关联回复配置问题

修复FastGPT知识库搜索为空时的上下文关联回复配置问题 现象 在FastGPT私有部署4.7.0版本中，配置知识库搜索为空时的指定回复分支后，执行对话时无法关联已有对话上下文完成回复逻辑，仅触发搜索为空的回复配置，无法实现预期的双重条件触发效果。 可能原因 当前回复分支的触发条件仅绑定了知识库搜索为空的…

2 分钟阅读
故障排查GitHub Issue

处理FastGPT 4.8.20+版本中ep开头模型ID固定配置问题

处理FastGPT 4.8.20+版本中ep开头模型ID固定配置问题 现象 FastGPT 4.8.20及以上版本中，存在模型ID以ep开头的目标模型，且系统配置中模型ID参数被固定写死，导致对应模型无法正常配置或调用。 可能原因 当前FastGPT版本的配置逻辑中，模型ID参数存在固定写死的情况，无法适配…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT使用过程中出现的异常问题

解决FastGPT使用过程中出现的异常问题 现象 FastGPT使用过程中出现异常，用户提交了两张报错相关的界面截图，未填写具体报错文本、复现步骤与预期结果。用户未确认已排查密钥有效性，未确认已完整查看官方文档与项目README，私有部署版本信息未填写完整。 可能原因 因缺少具体报错信息、复现步骤、部署版本…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT评估模块权限控制精细程度不足的问题

解决FastGPT评估模块权限控制精细程度不足的问题 现象 FastGPT评估模块现有权限体系无法实现精细权限控制，无法满足不同角色或用户的操作需求。在企业或组织多角色协作场景中，无法针对评估模块的不同操作分配对应权限，敏感操作无法仅限定给授权用户。 可能原因 现有评估模块的权限体系未设计精细的权限类型与角…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署知识库导出unAuthorization报错的排查解决方法

FastGPT私有部署知识库导出unAuthorization报错的排查解决方法 现象 本地HTTP访问FastGPT私有部署版本时，进入知识库页面点击导出操作会触发报错。服务端日志显示报错信息为[ERROR] 2024-04-08 08:49:30 export dataset error { messa…

2 分钟阅读
故障排查GitHub Issue

FastGPT 调用外部数据库与MinIO的配置方法

FastGPT 调用外部数据库与MinIO的配置方法 现象 用户希望复用已有数据库与MinIO服务，避免重复部署机器资源，但直接通过修改compose文件分离内置服务时，因环境变量配置复杂、参数较多，未能成功启动服务，无法实现节省资源的目标。 可能原因 直接分离内置数据库与MinIO服务时，需配置大量对应连…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT应用外链分享页面打开后报错的问题

解决FastGPT应用外链分享页面打开后报错的问题 现象 正常部署FastGPT后，创建应用并使用Markdown加载测试文档，通过外链分享该应用，打开分享链接后出现报错。 可能原因 因信息有限，需按实际环境确认，可能涉及部署配置、分享权限、文档加载逻辑或网络访问限制等。 排查步骤 1. 确认FastGPT…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT外链模式下点击反馈按钮无权限的问题

解决FastGPT外链模式下点击反馈按钮无权限的问题 现象 外链模式下点击反馈按钮时，系统弹出无权限提示，相关截图显示权限校验失败的弹窗内容。 可能原因 目前未明确具体触发原因，已知该问题出现在私有部署版本的FastGPT外链模式中，具体原因需按实际部署环境与配置确认。 排查步骤 1. 确认当前运行的Fas…

2 分钟阅读
故障排查GitHub Issue

FastGPT连接外部MongoDB实例超时问题排查与解决

FastGPT连接外部MongoDB实例超时问题排查与解决 现象 使用私有部署v4.8.11-fix版本的FastGPT，连接非本机的MongoDB数据库时出现超时错误。使用相同的docker-compose.yaml在本机部署时，可正常连接MongoDB，通过启动日志发现程序持续尝试连接名为"mongo"…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT应用中提取内容无法传递至指定回复的问题

解决FastGPT应用中提取内容无法传递至指定回复的问题 现象 在FastGPT中新建应用后，配置流程中添加将用户问题提取内容的步骤，并将该步骤关联至指定回复节点，此时指定回复区域显示为空，但系统已成功提取用户问题的内容。 可能原因 目前无公开的明确触发原因说明，需结合实际部署环境与应用配置流程进一步确认。…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署4.7.1版本上传文件集合接口404问题的排错方法

FastGPT私有部署4.7.1版本上传文件集合接口404问题的排错方法 现象 访问FastGPT向数据库上传文件集合的接口时，返回404错误。当前部署环境为私有部署版本4.7.1，且已确认使用的密钥可正常使用。 可能原因 可能的触发因素包括：后端服务未正常注册该接口的路由，服务启动时未加载相关功能模块，或…

2 分钟阅读