跳至主要内容
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私有部署版知识库上传md文件报错问题

解决FastGPT私有部署版知识库上传md文件报错问题 现象 在FastGPT 4.9.6私有部署版本的知识库上传功能中，拖拽.md格式文件时，系统提示"单次只支持上传多个文件或者一个文件夹"，导致文件无法正常上传。 可能原因 该问题源于上传组件的文件类型判断存在异常，当前判断条件为type === ''，…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库上传文档时e.replaceAll is not a function报错问题

解决FastGPT知识库上传文档时e.replaceAll is not a function报错问题 现象 在FastGPT公有云版本中，执行知识库上传文档操作时，出现报错提示“e.replaceAll is not a function”。复现流程为：登录系统后进入知识库页面，选择新建/导入功能，通过文…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库变量取消后配置残留导致对话报错的问题

解决FastGPT知识库变量取消后配置残留导致对话报错的问题 现象 设置知识库变量并取消后，UI界面显示正常，但发起对话时触发报错。导出系统配置后，可发现知识库变量配置项仍保留原有值。 可能原因 目前无明确根因信息，需结合系统运行日志与后端配置存储逻辑进一步排查，仅可明确该问题触发于知识库变量的取消操作。…

2 分钟阅读
故障排查GitHub Issue

FastGPT中信息抽取关键词关联知识库语义匹配的实现方法

FastGPT中信息抽取关键词关联知识库语义匹配的实现方法 现象 用户在使用FastGPT时，需要通过信息抽取模块分析问句得到关键词后，将每个关键词与知识库进行语义匹配改写，但不清楚信息抽取模块与知识库模块之间的设计衔接方式，无法完成该功能的落地。 可能原因 不清楚信息抽取模块输出的关键词如何与知识库模块进…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版知识库层级后退功能异常问题

解决FastGPT私有部署版知识库层级后退功能异常问题 现象 FastGPT私有部署4.8.5版本中，当知识库文件存在层级结构时，后退操作仅能回到全部数据库页面，无法像过往版本一样实现一级一级的层级后退。 可能原因 当前未明确具体触发异常的根源，需结合部署环境、代码变更记录或日志信息按实际情况确认。 排查步…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT添加知识库关联后问答上下文异常问题

解决FastGPT添加知识库关联后问答上下文异常问题 现象 添加知识库关联后，问答系统失去上下文理解能力。首次提问“最近比较好看的电影有哪些”时，回答符合预期；后续追问“国内的呢”时，返回与电影主题完全不相关的知识库检索内容。相关上传截图记录了完整的对话交互与检索结果。 可能原因 无明确的已知关联配置项或参…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库检索返回重复引用文件的问题

解决FastGPT知识库检索返回重复引用文件的问题 现象 FastGPT知识库检索功能返回的引用文件清单存在重复条目，相同的文档会多次出现在返回结果中，例如同一文件名会重复出现在引用列表内，不符合预期的单一文件名称返回要求，影响检索结果的准确性。 可能原因 目前无公开的明确触发逻辑，需结合实际运行环境排查具…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库回答展示智能导诊超链接的问题

解决FastGPT知识库回答展示智能导诊超链接的问题 现象 FastGPT私有部署场景下，知识库返回的智能导诊相关内容仅展示普通网址形式，无法展示为可点击的智能导诊超链接，不符合预期的展示需求。 可能原因 需按实际部署环境、系统配置及版本情况确认，暂无明确已知的通用原因。 排查步骤 1. 确认当前FastG…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库问答场景下的图片加载失败问题

解决FastGPT知识库问答场景下的图片加载失败问题 现象 知识库问答场景中，部分图片无法正常加载，无法正常显示的图片对应知识库中配置的图片资源。 可能原因 知识库中配置的图片路径添加了baseurl参数，引发路径拼接逻辑异常，无法正确指向并获取图片资源。 排查步骤 1. 检查知识库内配置的图片路径是否添加…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库图片无法在问答环节正常输出的问题

解决FastGPT知识库图片无法在问答环节正常输出的问题 现象 FastGPT知识库通过录入或文档导入的方式支持Markdown格式内容，但在问答输出环节，知识库中包含的图片无法正常输出。该问题在知识库存有大量图片时尤为明显，用户尝试通过在提示词中提及图片、截图相关内容，或在知识库Markdown格式内容前…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库手动插入或上传文件时的报错问题

解决FastGPT知识库手动插入或上传文件时的报错问题 现象 FastGPT正常聊天功能可正常使用，在知识库执行手动插入数据或文件上传操作时出现报错。使用配置的模型时均触发该问题。 可能原因 暂无可通过现有信息直接确认的具体原因，需结合系统运行日志、配置项进行排查。 排查步骤 1. 确认当前FastGPT为…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT知识库QA对向量相似度匹配度偏低问题

解决FastGPT知识库QA对向量相似度匹配度偏低问题 现象 在FastGPT 4.8.2私有部署版本中，同时上传QA对类型CSV和文本类型文件作为知识库时，检索QA对中已有的问题，其向量相似度匹配度偏低。 可能原因 QA对形式的数据集会将Q和A内容共同作为检索内容，而检索时往往仅输入问题内容，导致匹配度降…

2 分钟阅读