故障排查GitHub Issue
配置FastGPT引用模板的相似度变量以调整输出内容
配置FastGPT引用模板的相似度变量以调整输出内容 现象 引用模板无法基于匹配结果的相似度调整输出内容，无法实现根据相似度差异生成差异化回答。 可能原因 FastGPT的引用模板默认未集成相似度相关变量，无法获取匹配结果的相似度数值用于动态调整回答逻辑。 排查步骤 1. 确认当前FastGPT版本是否包含…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
配置FastGPT实现AI处理结果仅作为中继调用
配置FastGPT实现AI处理结果仅作为中继调用 现象 在使用FastGPT的AI对话或知识库查询功能时，AI处理后的结果会直接输出给客户端。部分业务场景需要AI仅根据知识库和提示词整理内容，仅将处理结果推送至其他逻辑进行二次加工，不直接反馈给客户端，当前版本无法满足该需求。 可能原因 现有FastGPT的…
故障排查GitHub Issue
解决FastGPT聊天过程中重复触发用户信息HTTP提交的问题
解决FastGPT聊天过程中重复触发用户信息HTTP提交的问题 现象 在聊天过程中抽取用户姓名、联系方式等用户信息，将抽取结果通过HTTP提交至后台系统。期望在提交成功后，不再重复执行用户信息抽取和HTTP提交操作，但实际每次发起聊天会话时，都会触发用户信息抽取成功，并再次执行一次HTTP提交操作。 可能原…
故障排查GitHub Issue
解决FastGPT回复中自定义显示文本跳转链接的配置问题
解决FastGPT回复中自定义显示文本跳转链接的配置问题 现象 在FastGPT的对话回复中，需配置可点击的跳转链接，仅显示预先设定的自定义文本（如点击这里访问百度），不显示完整URL，同时通过该链接直接调用其他模块或插件，以实现对话引导功能。例如回复中需展示“1表示满意并关闭咨询”“2联系人工”这类带跳转…
故障排查GitHub Issue
FastGPT中实现AI回复类文件格式展示的排错与解决方法
FastGPT中实现AI回复类文件格式展示的排错与解决方法 现象 使用FastGPT的过程中，存在两类需求：一是希望AI回复能够展示类似文件的内容格式，二是需要对聊天页面的数据进行封装以实现该展示效果。同时，通过插件生成的回复内容视觉效果不够美观，无法达到预期的展示体验，用户曾尝试相关方案但未获得满意效果。…
故障排查GitHub Issue
解决FastGPT回复中途中断并提前结束会话的问题
解决FastGPT回复中途中断并提前结束会话的问题 现象 使用FastGPT时，回复内容输出至中途停止，停顿数秒后会话提前结束。该问题在使用NVIDIA T4 GPU的环境中较为常见，部分场景下表现为回复不全，属于断卡类异常。 可能原因 目前已知关联的异常因素包括Python进程偶然发送异常字符串、模型调用…
故障排查GitHub Issue
FastGPT API输入参数从req.body获取的排错方法
FastGPT API输入参数从req.body获取的排错方法 现象 使用FastGPT的API输入功能时，无法在官方文档中找到对应配置信息，仅在项目源码中发现从req.body处获取参数的逻辑。该问题可出现于公有云或私有部署版本的FastGPT中，使用者使用了可正常工作的密钥。 可能原因 结合问题现象，可…
故障排查GitHub Issue
解决FastGPT中重排模型配置后返回404且无法启用的问题
解决FastGPT中重排模型配置后返回404且无法启用的问题 现象 使用Docker启动bge-rerank-v2-m3模型后，在OneAPI中配置该重排模型，调用时返回404错误。同时无法在AI能力组件中找到重排模型相关配置项。 可能原因 重排模型无法通过OneAPI接入，需直接接入FastGPT平台。此…
故障排查GitHub Issue
解决FastGPT中reRank模型Docker日志无显示的问题及排查方法
解决FastGPT中reRank模型Docker日志无显示的问题及排查方法 现象 在FastGPT的config.json中成功配置对应参数后，创建应用时reRank模型对应的Docker日志无任何显示。部署环境中，使用One API作为chatglm3本地部署与m3e Docker容器的代理接口，reRa…
故障排查GitHub Issue
FastGPT 4.8.22–4.8.23-fix 接入 Xinference 索引与重排排查
FastGPT 4.8.22–4.8.23-fix 接入 Xinference 索引与重排排查 适用场景与历史记录 原报告涉及 4.8.22、4.8.23、4.8.23-fix：Xinference 聊天模型可调用，索引和重排模型配置失败。 原始讨论提交于 2025-02-28，本页按该记录说明症状或需求的…
故障排查GitHub Issue
FastGPT 4.7版本开启结果重排后未生效的排障指南
FastGPT 4.7版本开启结果重排后未生效的排障指南 现象 升级至FastGPT 4.7版本后，在设置中开启结果重排功能，但实际对话过程中重排未生效。部分用户部署重排服务时，接口调用返回200 OK，但前端显示重排未生效；重排服务运行时会输出TypedStorage相关的Python弃用警告日志。 可能…
故障排查GitHub Issue
解决FastGPT勾选重排选项后响应时间过长的问题
解决FastGPT勾选重排选项后响应时间过长的问题 现象 在FastGPT私有部署环境中，勾选重排选项后，接口响应时间超过35秒；不勾选重排选项时，运行时间约为5秒。该响应延迟仅在启用重排功能时出现，未启用该功能时系统运行正常，属于典型的功能触发式性能异常。 可能原因 结合重排功能的运行逻辑与问题表现，未启…