跳至主要内容
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知识库导出返回403凭证错误的问题

解决FastGPT知识库导出返回403凭证错误的问题 现象 私有部署场景下，执行知识库导出操作时，返回报错信息{"code":403statusText:"unAuthorization"message:"凭证错误"data:null}。 可能原因 该报错提示凭证错误，可能涉及导出操作的凭证配置不符合校验规…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署版本知识库导出CSV文件异常的解决方法

FastGPT私有部署版本知识库导出CSV文件异常的解决方法 现象 在FastGPT私有部署版本v4.8.9-alpha中执行知识库导出操作时，仅能生成大小为88字节的CSV格式文件，且文件内容不符合正常知识库导出的预期格式。 可能原因 目前无官方明确标注的关联原因，需结合实际部署环境与系统日志信息确认。可…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库文件夹选择与元数据配置问题

解决FastGPT知识库文件夹选择与元数据配置问题 现象 当前使用FastGPT时，无法在知识库选择环节选中库下的文件夹来限定检索范围，同时无法为上传的文档配置元数据标签，无法通过元数据实现更精细的文档管理，难以满足企业级的精细化知识库控制需求。 可能原因 现有FastGPT版本未提供知识库文件夹选择与文档…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库介绍内容保存后失效的问题

解决FastGPT知识库介绍内容保存后失效的问题 现象 FastGPT知识库的介绍内容无法正常保留。编辑介绍内容并保存后，界面显示更新成功提示，但退出当前页面并刷新后，知识库介绍内容恢复为空状态。本次反馈附带多张操作截图用于佐证问题。 可能原因 未明确已知的触发原因，需结合实际部署环境、操作细节与日志信息进…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库元数据无法界面查看和引用的问题

解决FastGPT知识库元数据无法界面查看和引用的问题 现象 在使用FastGPT搭建AI客服场景时，需让AI返回参考文件的元数据信息，如分类、下载地址等，以提升回复可信度。当前仅能通过API创建知识库集合时配置Metadata字段，但无法通过界面查看已配置的元数据，且工作流中无法引用知识库的元数据返回结果…

2 分钟阅读
故障排查GitHub Issue

FastGPT知识库相关查询无法处理的排查与解决方法

FastGPT知识库相关查询无法处理的排查与解决方法 现象 当发起知识库层面的查询时，无法得到符合预期的处理结果。典型场景包括询问知识库包含的主要文件、知识库中关于怀化的文件数量这类问题，无法返回正确响应。 可能原因 暂未明确具体触发原因，需结合实际部署环境、调用日志与配置信息进一步确认。 排查步骤 1.…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库问题优化的默认模型调用逻辑异常

解决FastGPT知识库问题优化的默认模型调用逻辑异常 现象 在FastGPT v4.8私有部署版本中，当知识库开启问题优化功能且未手动选择AI模型时，系统会默认使用config.json配置的第一个模型，未遵循用户的配置预期。 可能原因 该问题由知识库问题优化功能的默认模型调用逻辑缺陷导致，逻辑未校验是否…

2 分钟阅读
故障排查GitHub Issue

FastGPT知识库召回次数统计功能的配置与使用说明

FastGPT知识库召回次数统计功能的配置与使用说明 现象 无法查看FastGPT知识库中每个collection和data的召回次数统计数据，无法识别高频召回的高价值知识块、低频或零召回的低效知识块，难以针对性优化知识库整体性能，也无法验证知识库调整对检索效果的影响。 可能原因 1. 当前FastGPT版…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库搜索上限变更后无法限制单问题返回结果的问题

解决FastGPT知识库搜索上限变更后无法限制单问题返回结果的问题 现象 FastGPT公有云新版本将知识库单次搜索的上限从条数限制调整为tokens数量限制。使用时，发起单个问题的提问，系统会返回包含多个问题（如问题1至问题5）的知识库匹配结果。旧版本可通过单次搜索条数上限（topK）限制仅返回对应问题的…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.9.6版本知识库搜索返回超时问题

解决FastGPT 4.9.6版本知识库搜索返回超时问题 现象 FastGPT 4.9.6私有部署版本中，知识库的混合检索与语义检索返回时间均超过30秒。向量模型使用阿里text-embedding-v2，单独响应时间约100ms。 可能原因 当前已知向量模型单独响应正常，但整体搜索耗时远超模型响应时长，且…

2 分钟阅读
故障排查GitHub Issue

FastGPT知识库向量化速度低的优化与排查方案

FastGPT知识库向量化速度低的优化与排查方案 现象 建立知识库并上传数百个小说文档时，使用m3e模型进行向量化，CPU和GPU使用率偏低，向量化总耗时长达十几个小时。 可能原因 需按实际部署环境确认具体原因，已知关联因素包括硬件资源未被充分利用、批量处理的并发设置不足。 排查步骤 1. 查看FastGP…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.7.1私有部署版绑定Laf账号出错问题

解决FastGPT 4.7.1私有部署版绑定Laf账号出错问题 现象 FastGPT 4.7.1私有部署版本在执行Laf账号绑定操作时触发报错，无法完成绑定流程，具体报错细节可参考配套上传的截图内容。 可能原因 当前仅明确报错场景为绑定Laf账号失败，未公开具体的固定诱因。报错可能与配置参数、网络连接、密钥…

2 分钟阅读