故障排查GitHub Issue
解决FastGPT升级后流程调试时变量关联为空的报错问题
解决FastGPT升级后流程调试时变量关联为空的报错问题 现象 在FastGPT流程调试场景中，调试升级前创建的流程时，会触发控件报错提示，提示变量未正确关联，该问题影响多数旧版流程。 可能原因 经确认，该报错仅在使用数组类型变量的流程中出现，属于旧版流程数据结构与新版系统的兼容问题。 排查步骤 1. 定位…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT升级后版本号显示异常与功能不匹配问题
解决FastGPT升级后版本号显示异常与功能不匹配问题 现象 用户升级FastGPT到4.8.14版本后，页面显示的版本号仍为13，分享链接对应的功能与版本描述的功能不匹配，怀疑升级步骤存在错误。 可能原因 升级操作未正确执行，导致实际运行的镜像版本未更新，或容器未加载新版本的系统配置文件。 排查步骤 1.…
故障排查GitHub Issue
解决FastGPT上传文件无法读取或触发上传失败的问题
解决FastGPT上传文件无法读取或触发上传失败的问题 现象 用户反馈上传的文件未被系统读取。部分场景下，测试界面可正常上传文件，但对话界面无法触发上传；小文件（如几字节、500字节左右）可触发上传接口，大文件无法触发且无任何提示。升级到v4.8.22版本后，上传操作出现404异常。日志显示上传成功，但无文…
故障排查GitHub Issue
为FastGPT配置开放上传文件接口以通过文件ID进行对话
为FastGPT配置开放上传文件接口以通过文件ID进行对话 现象 用户在使用FastGPT时，希望通过开放的文件上传接口上传文件，并使用返回的文件ID直接发起对话，但当前未提供该类公开接口，无法实现对应功能。 可能原因 当前FastGPT未开放公开的文件上传接口，无法通过接口完成文件上传并获取绑定的文件ID…
故障排查GitHub Issue
FastGPT 4.8.22 与 Milvus 环境上传 Markdown 的历史排查
FastGPT 4.8.22 与 Milvus 环境上传 Markdown 的历史排查 适用场景与历史记录 原报告描述私有部署 4.8.22 上传 .md 文档出错，评论补充使用 Milvus。 原始讨论提交于 2025-02-26，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 Markdow…
故障排查GitHub Issue
解决FastGPT知识库URL导入时的MongoDB事务报错问题
解决FastGPT知识库URL导入时的MongoDB事务报错问题 现象 FastGPT私有部署版本4.6.8中，知识库通过URL导入时，会弹出报错"Transaction numbers are only allowed on a replica set member or mongos "，此时导入普通文…
故障排查GitHub Issue
解决FastGPT通过URL新建文本数据集时视频标签被忽略的问题
解决FastGPT通过URL新建文本数据集时视频标签被忽略的问题 现象 针对FastGPT私有部署版本v4.9.6，通过URL新建文本数据集时，网页内的video标签在转换生成的Markdown文件中会被忽略，无法保留原视频信息。用户期望将video标签转换为Video格式以保留视频信息。 可能原因 未明确…
故障排查GitHub Issue
FastGPT实现用户使用前弹窗确认功能的排错指南
FastGPT实现用户使用前弹窗确认功能的排错指南 现象 用户在FastGPT 4.8.8版本中，希望实现用户使用前弹窗确认免责声明或重要提醒的功能。尝试通过全局下拉单选变量借助必选机制实现确认流程，但该方式的输出框长度、显示效果与使用体验不佳。 可能原因 1. 系统对话机制未内置用户体系，无法实现基于用户…
故障排查GitHub Issue
解决FastGPT工作流中用户输入内容无法传递至后续节点的问题
解决FastGPT工作流中用户输入内容无法传递至后续节点的问题 现象 在FastGPT工作流中，无法将用户输入节点的内容直接作为后续节点的输入内容。例如在写作场景中，创意人员提出想法后，无法让用户选择的选题直接传递至下一个节点进行处理。 可能原因 现有用户输入节点未支持将自身输入内容作为可输出变量，导致工作…
故障排查GitHub Issue
解决FastGPT应用中core.chat.error.User question empty报错问题
解决FastGPT应用中core.chat.error.User question empty报错问题 现象 使用ghcr.io/labring/fastgpt:latest镜像创建知识库与对话引导应用后，在应用内与FastGPT对话时，输入第二个问题后系统自动提示“问题补全”，随后抛出报错core.cha…
故障排查GitHub Issue
FastGPT 动态业务列表接入用户选择的历史需求
FastGPT 动态业务列表接入用户选择的历史需求 适用场景与历史记录 原议题希望从 HTTP 或数据库取得用户订单，将列表动态交给用户选择组件。 原始讨论提交于 2025-06-17，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 节点定义使用预设选项与分支，原线程缺少外部数组直连的完成确认。…
故障排查GitHub Issue
解决FastGPT中用户选择交互结果未正常展示的问题
解决FastGPT中用户选择交互结果未正常展示的问题 现象 使用FastGPT的选择类交互功能时，用户的选择消息无法正常显示，仅存在高亮选中状态，未以一问一答的形式展示用户选择的内容，与官方文档中的交互展示效果不符。 可能原因 默认的选择交互逻辑仅通过高亮标识选中项，未主动输出用户选择的文本内容。若需展示选…