故障排查GitHub Issue
解决FastGPT开源版本与公有云版本使用混淆问题
解决FastGPT开源版本与公有云版本使用混淆问题 现象 部分用户在FastGPT开源版本的GitHub仓库提交issue时，未填写问题描述、复现步骤、预期结果等有效信息，且所提问题涉及收费相关或公有云版本的范畴。 可能原因 未明确区分FastGPT开源部署版本与公有云版本的使用场景，未查阅仓库相关说明，错…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
FastGPT开源版本暂不支持知识图谱类复杂关系查询
FastGPT开源版本暂不支持知识图谱类复杂关系查询 现象 用户确认已升级到FastGPT最新开源版本并查看过项目README，未找到类似功能。期望实现基于条件的复杂文档查询，例如提取合同金额大于100000的文档。现有向量检索功能无法满足该场景需求，计划通过引入知识图谱完成复杂关系查询，但使用现有功能无法…
故障排查GitHub Issue
FastGPT open_url节点引用变量后url为null的排错方法
FastGPT openurl节点引用变量后url为null的排错方法 现象 在FastGPT中配置type为openurl的节点时，使用{{weburl1}}、{{{{$hwblsXt0xdcRUugd.weburl1$}}}}、{{{{$pluginInput.weburl1$}}}}三种方式引用变量，…
故障排查GitHub Issue
配置FastGPT的OpenAI JSON模式及解答相关配置使用疑问
配置FastGPT的OpenAI JSON模式及解答相关配置使用疑问 现象 用户希望在AI对话节点添加OpenAI JSON模式开关，使用中发现无法直接启用该模式，同时对内容提取模块的调用逻辑存在疑问，不清楚其是否需要二次调用模型，且相关配置文档对必填提取文本的用途说明不够清晰。 可能原因 一是未在API请…
故障排查GitHub Issue
为FastGPT无法通过OpenAPI绑定应用提供具体排障方法
为FastGPT无法通过OpenAPI绑定应用提供具体排障方法 现象 在使用FastGPT开展二次开发工作时，会遇到无法通过公开OpenAPI接口完成应用绑定的问题。该应用绑定功能仅能通过FastGPT后台页面手动操作完成，无法通过代码调用实现自动化绑定，会降低二次开发的效率与便捷性，影响开发流程的顺畅性。…
故障排查GitHub Issue
解决FastGPT OpenAPI chat接口缺少异步调用功能的问题
解决FastGPT OpenAPI chat接口缺少异步调用功能的问题 现象 使用FastGPT OpenAPI的chat接口时，无法实现异步调用。接口未提供提交异步任务与查询任务执行状态的相关接口，无法适配长执行时间工作流的异步回调场景。在Serverless环境中调用此类接口时，同步等待长耗时任务会导致…
故障排查GitHub Issue
FastGPT 模型错误后空响应：工作流异常分支与 API 核对
FastGPT 模型错误后空响应：工作流异常分支与 API 核对 适用场景与历史记录 原议题描述大模型组件报错后对外返回空内容，希望能够捕获异常；后续评论涉及 OpenAPI 调用。 原始讨论提交于 2025-02-20，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 维护者当时表示已列入计划。…
故障排查GitHub Issue
解决FastGPT中OpenRouter返回思考内容字段不匹配问题
解决FastGPT中OpenRouter返回思考内容字段不匹配问题 现象 在FastGPT中配置OpenRouter渠道时，添加请求体参数"includereasoning": true以开启思考过程返回，此时OpenRouter返回的思考过程存储在reason字段，但FastGPT预期的存储字段为reas…
故障排查GitHub Issue
FastGPT工具箱数据库连接无法兼容Oracle数据库的排错指南
FastGPT工具箱数据库连接无法兼容Oracle数据库的排错指南 现象 使用FastGPT工具箱的数据库连接功能时，无法完成Oracle数据库的连接配置与使用，无法实现基于Oracle数据库的相关数据操作。 可能原因 FastGPT原有数据库连接模块因Oracle数据库依赖与产品其他依赖存在冲突，已被移除…
故障排查GitHub Issue
解决FastGPT高级编排模块局限与数据引用异常问题
解决FastGPT高级编排模块局限与数据引用异常问题 现象 使用FastGPT高级编排功能时，http模块返回的数据无法被AI对话模块解析并用于回复用户。现有编排模块存在局限，缺少支持编排赋值的变量模块与数据判断模块，无法完成将http返回结果赋值存储、基于数据进行分支判断且不消耗token的操作。部分场景…
故障排查GitHub Issue
FastGPT 接入 PaddleOCR-VL 增强解析的历史需求
FastGPT 接入 PaddleOCR-VL 增强解析的历史需求 适用场景与历史记录 原议题于 2025 年请求增加 PaddleOCR-VL 增强解析支持，讨论中记录了具体模型的接入需求。 原始讨论提交于 2025-10-20，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 该请求不足以确定…
故障排查GitHub Issue
FastGPT页面因浏览器兼容或翻译设置异常导致崩溃的排查与解决
FastGPT页面因浏览器兼容或翻译设置异常导致崩溃的排查与解决 现象 部分场景下出现页面崩溃问题，多数触发场景为特定浏览器环境，或开启中文翻译功能后出现。 可能原因 一是浏览器存在兼容异常；二是系统内的中文翻译功能开启引发兼容冲突。 排查步骤 1. 记录页面崩溃时的使用环境，包括浏览器类型、是否开启中文翻…