跳至主要内容
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 4.6.8升级后知识库搜索最低相关度设置丢失问题

解决FastGPT 4.6.8升级后知识库搜索最低相关度设置丢失问题 现象 FastGPT私有部署版本从4.6.7升级至4.6.8后，进入应用的知识库搜索参数配置页面，无法找到最低相关度设置项。官方在线版本的该配置页面仍保留此设置项。 可能原因 该问题仅出现在私有部署版本的升级场景中，具体的配置项变更原因未…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.6.8版本指定回复模块内容混杂问题排查与解决

FastGPT 4.6.8版本指定回复模块内容混杂问题排查与解决 现象 FastGPT v4.6.8版本更新后，指定回复模块的内容会与AI对话的内容混在一起。用户预期的输出顺序为，先完整输出AI对话的全部内容，再输出指定回复模块的内容，例如“以上内容来自AI”。该问题在公有云版本与私有部署版本中均有出现。…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.7版本配置vllm多模态模型无图片输入开关的排查

FastGPT 4.7版本配置vllm多模态模型无图片输入开关的排查 现象 用户使用FastGPT 4.7私有部署版本，通过oneapi配置自定义渠道指向vllm部署的qwen2-vl-72B-instruct模型API。配置完成后，在FastGPT的模型配置界面未找到开启图片输入的开关，当前界面仅展示大语…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署4.7.1版本相关报错排查方法

FastGPT私有部署4.7.1版本相关报错排查方法 现象 使用FastGPT私有部署4.7.1版本时触发报错，已提交报错截图，但未在issue中明确描述具体报错文本内容。使用的自有密钥已确认可正常使用。 可能原因 当前仅明确部署版本为4.7.1私有部署、使用自有可用密钥，未获取到具体报错日志文本，无法直接…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.8.14版本cosyvioce语音播放异常排查

FastGPT 4.8.14版本cosyvioce语音播放异常排查 现象 FastGPT升级至4.8.14版本后，cosyvioce功能无法正常使用。无法针对AI生成的回复文本执行语音播放操作，且该问题每次使用时均会出现，无额外触发条件限制。 可能原因 目前无明确的已知原因，仅确认该问题出现于FastGPT…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.8.14私有部署版本异常排查指南

FastGPT 4.8.14私有部署版本异常排查指南 现象 私有部署FastGPT 4.8.14版本时出现功能异常，用户上传了两张日志截图以辅助排查问题，未明确说明具体的异常表现、复现流程与预期结果。该用户已确认自身使用的API Key可正常使用，且未提供其他额外的问题描述信息。 可能原因 由于未获取到日志…

3 分钟阅读
故障排查GitHub Issue

FastGPT 4.8.16版本知识库脏数据问题排查与解决

FastGPT 4.8.16版本知识库脏数据问题排查与解决 现象 FastGPT 4.8.16版本中，AI回复出现大量脏数据。查看对话记录内的知识库检索结果，发现检索内容在对应源文件中不存在，甚至包含过往用户与AI的沟通内容，该问题近期频繁出现。用户下载对应源文件后确认无相关条目，运行官方清理无效数据脚本后…

3 分钟阅读
故障排查GitHub Issue

FastGPT 4.8.17版本AI回复后对话异常中断的排错方法

FastGPT 4.8.17版本AI回复后对话异常中断的排错方法 现象 AI已生成完整回复结果，但后续流程无法正常执行，当前对话直接结束，该问题为偶发出现，无固定触发规律。 可能原因 目前无明确已知触发条件，仅记录为私有部署4.8.17版本下的偶发异常，具体诱因需结合实际运行环境确认，暂未发现通用的直接诱因…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.8.17版本导入文件卡在3组索引的问题

解决FastGPT 4.8.17版本导入文件卡在3组索引的问题 现象 导入文件后，系统界面持续卡在"3组索引中"的状态，无法推进后续流程。 可能原因 无明确预设关联异常类型，需结合实际部署环境确认。常见关联方向包括索引创建进程异常、部署资源不足或配置参数异常，具体需通过排查确定。 排查步骤 1. 确认当前使…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.8.20私有部署版本报错排查指南

FastGPT 4.8.20私有部署版本报错排查指南 现象 FastGPT 4.8.20私有部署版本运行过程中出现异常报错，用户已确认自身使用的密钥可正常调用服务，但仍出现问题，同时上传了相关日志截图。 可能原因 具体原因需结合报错日志内容确认，可能涉及部署配置参数异常、关联服务运行故障或版本兼容问题，也可…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.8.3私有部署版高级编排应用历史记录丢失问题

解决FastGPT 4.8.3私有部署版高级编排应用历史记录丢失问题 现象 FastGPT 4.8.3私有部署版本中，高级编排应用的AI历史记录出现丢失且无法找回的情况。该问题在将应用转发至HTTP服务后出现，仅在高级编排应用中被发现。 可能原因 暂未明确该问题的直接诱因，相关信息需结合实际部署环境进一步确…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.8.3版本参数过滤异常排查指南

FastGPT 4.8.3版本参数过滤异常排查指南 现象 在FastGPT 4.8.3私有部署版本中，使用字符串与数字参数时出现三类异常：1. 字符串无法判断等于、开头匹配，仅可做空判断；2. 版本更新日志提及的正则表达式功能无法正常使用；3. 多条件并（a&b）逻辑分支触发异常，非两个条件均为true时也…

2 分钟阅读