故障排查GitHub Issue
解决FastGPT无法支持PPT文档问答的问题
解决FastGPT无法支持PPT文档问答的问题 现象 FastGPT 无法对 PPT 格式文档进行问答交互，无法正常解析并读取 PPT 文档内容以提供相关问答服务。 可能原因 FastGPT 默认未集成 PPT 文档的解析能力，未配置针对 PPT 格式的文档处理适配规则。 排查步骤 1. 确认当前 Fast…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT PPT生成插件模板选择交互复杂的问题
解决FastGPT PPT生成插件模板选择交互复杂的问题 现象 用户尝试在FastGPT中使用插件，根据传入的PPT目录结构与内容，通过选择指定模板或上传PPT模板生成不同类型的PPT，无法实现该功能。 可能原因 该功能所需的模板选择交互逻辑超出FastGPT插件的能力范围，属于独立应用范畴，无法通过Fas…
故障排查GitHub Issue
解决FastGPT文档解析模块处理转换后的PPTX文件报错的问题
解决FastGPT文档解析模块处理转换后的PPTX文件报错的问题 现象 将doc、xls、ppt文件转换为docx、xlsx、pptx格式后，通过FastGPT文档解析模块处理时，docx与xlsx文件可正常解析，但pptx文件触发报错。报错信息包含：[xmldom error] invalid doc s…
故障排查GitHub Issue
配置FastGPT避免无效应答被加入对话上下文
配置FastGPT避免无效应答被加入对话上下文 现象 当用户发送存在负向内容的提问时，AI返回警告类无效应答。这类无效应答被默认加入对话上下文，对后续对话无实际意义，且额外消耗token，同时干扰后续AI回答的准确性。 可能原因 FastGPT默认将所有完成的对话轮次内容保存为上下文，用于后续对话的理解参考…
故障排查GitHub Issue
解决私有云部署FastGPT创建知识库提示modeldata不存在的问题
解决私有云部署FastGPT创建知识库提示modeldata不存在的问题 现象 在私有云环境部署最新版FastGPT后，执行创建知识库操作时，系统会提示modeldata不存在的错误。该问题在公网部署的FastGPT环境中未出现。 可能原因 该报错仅在私有云部署的FastGPT场景中出现，公网部署环境无此异…
故障排查GitHub Issue
解决FastGPT私有部署嵌入数据库插入数据422报错问题
解决FastGPT私有部署嵌入数据库插入数据422报错问题 现象 私有部署FastGPT时，调用embedding功能向数据库插入数据时返回422错误；对话场景中使用embedding功能无异常报错。 可能原因 该问题为未升级的FastGPT旧版本存在的已知程序缺陷，官方已发布对应修复版本。 排查步骤 1.…
故障排查GitHub Issue
获取FastGPT私有部署免登录窗口的客户端IP方法
获取FastGPT私有部署免登录窗口的客户端IP方法 现象 使用FastGPT私有部署4.8.13版本的免登录窗口时，部分安全管控场景下需获取访问该窗口的客户端IP，但当前无公开的官方获取路径，无法直接通过平台内置功能获取相关信息。 可能原因 FastGPT的访问日志记录逻辑、存储位置及字段配置会随部署环境…
故障排查GitHub Issue
解决FastGPT私有部署版超级管理员密码重启后重置问题
解决FastGPT私有部署版超级管理员密码重启后重置问题 现象 在FastGPT私有部署版本中，修改超级管理员密码后，每次重启服务，密码都会被重置为初始状态。该问题未在公有云版本中出现，仅影响私有部署的FastGPT实例。用户已完成例行检查，确认无类似issue，已查阅项目README与相关文档，且自身使用…
故障排查GitHub Issue
FastGPT私有部署4.14.22版本插件导入失败的排障方法
FastGPT私有部署4.14.22版本插件导入失败的排障方法 现象 本地部署FastGPT 4.14.22版本时，从https://v2.marketplace.fastgpt.cn下载的插件导入失败，报错信息为Cannot find package '@fastgpt-plugin/sdk-factor…
故障排查GitHub Issue
解决FastGPT私有部署版本AI回复无流式输出问题
解决FastGPT私有部署版本AI回复无流式输出问题 现象 FastGPT 4.6.4私有部署版本中，所有对话场景下AI回复均无打字机逐字输出效果，内容一次性全部显示，未实现流式输出效果。用户通过群聊确认API密钥可用且部署环境未挂载CDN。 可能原因 该问题大概率由网关配置异常或Nginx配置存在问题导致…
故障排查GitHub Issue
FastGPT 工作流异常捕获与报错反馈配置
FastGPT 工作流异常捕获与报错反馈配置 适用场景与历史记录 原议题于 2023 年请求工作流支持错误事件或 try/catch。 原始讨论提交于 2023-12-27，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 后续维护者明确确认该能力已有，当前源码也包含异常分支与错误输出。具体节点的…
故障排查GitHub Issue
解决FastGPT平台提示词获取与召回chunk溯源相关问题
解决FastGPT平台提示词获取与召回chunk溯源相关问题 现象 用户在使用FastGPT过程中，存在两个未得到明确解答的疑问：一是希望获取官方提供的提示词案例，二是不清楚当精召回3个chunk后，模型如何确认答案基于哪个chunk生成。 可能原因 一是未找到官方公开的提示词示例资源，二是对精召回chun…