故障排查GitHub Issue
解决FastGPT判断器与流程控制异常及自动保存问题
解决FastGPT判断器与流程控制异常及自动保存问题 现象 判断器输入文本重复且自动打断；无法基于判断器结果进行分支选定，其他分支部件莫名运行；变量需手动选取且无法重复使用；自动保存功能异常，测试过程中出现报错导致数据丢失；4.8版本歧义多于4.7版本，复杂逻辑流程控制难度提升。 可能原因 版本升级后存在自…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT判断器节点批量选择变量条件的效率问题
解决FastGPT判断器节点批量选择变量条件的效率问题 现象 在FastGPT判断器节点中，当存在五六十个判断项时，需逐个点选变量、选择条件及具体值。虽可通过复制解决值的填入，但重复点选变量与选择条件的操作效率极低，且易出现配置错误。 可能原因 当前FastGPT判断器节点未提供批量选择变量、条件或值的功能…
故障排查GitHub Issue
FastGPT基于K3s一键部署后服务异常排查与解决
FastGPT基于K3s一键部署后服务异常排查与解决 现象 使用提供的一键部署方案部署FastGPT后，基于K3s的部署环境出现服务异常。该部署方案基于K3s服务器环境，由微擎交付系统作为K3s的可视化管理控制面板，具体异常表现需按实际环境确认。 可能原因 K3s集群的节点运行状态出现异常，微擎交付系统中F…
故障排查GitHub Issue
解决FastGPT K8s部署pluginTemplates目录缺失问题
解决FastGPT K8s部署pluginTemplates目录缺失问题 现象 在Kubernetes环境部署FastGPT时，会出现pluginTemplates目录缺失的报错，导致服务无法正常加载模板资源。部分场景下即使Dockerfile中配置了复制该目录的指令，仍会触发该报错。此外，使用Helm方式…
故障排查GitHub Issue
解决FastGPT关闭知识库文件夹启用后数据集仍启用的问题
解决FastGPT关闭知识库文件夹启用后数据集仍启用的问题 现象 使用FastGPT公有云或私有部署v4.8.9版本时，在知识库管理界面关闭指定文件夹的“启用”开关后，该文件夹内包含的所有数据集仍保持启用状态。调用知识库进行检索时，系统仍会搜索该文件夹内的知识内容，未达到预期的联动关闭效果。预期效果为关闭文…
故障排查GitHub Issue
解决FastGPT知识库集合索引仅支持UI配置的问题
解决FastGPT知识库集合索引仅支持UI配置的问题 现象 当前FastGPT的知识库集合索引配置仅支持通过UI界面操作，无法通过OpenAPI接口完成配置。例如在批量创建900余个产品相关知识库集合的场景中，需为每个集合配置产品型号相关索引以提升召回精度，仅通过UI逐个配置的效率较低，无法满足批量自动化配…
故障排查GitHub Issue
解决FastGPT中知识库较多时模型输出截断的问题
解决FastGPT中知识库较多时模型输出截断的问题 现象 加载较多知识库时，模型输出常中途截断。当知识库仅包含12本书时，模型输出完整；知识库内容较多时，输出到一半即停止。使用硬件为40902，max-model-len设为18048，总token配置为18000，索引字数4000多，未触发总token限制…
故障排查GitHub Issue
解决FastGPT知识库问答中提示词配置导致的回复效果差异问题
解决FastGPT知识库问答中提示词配置导致的回复效果差异问题 现象 FastGPT 4.8.9版本的知识库+AI场景中，使用两段相同的提示词仅在是否要求输出思考过程上存在差异，回复效果明显不同。当用户输入模糊查询“电话”时，要求输出思考过程的提示词可返回多个不同电话并提示用户进一步明确；不要求输出思考过程…
故障排查GitHub Issue
FastGPT知识库单个文件生成摘要与标签的实现方法
FastGPT知识库单个文件生成摘要与标签的实现方法 现象 用户需求为对FastGPT知识库中的每个文件生成摘要、为单个文档打上标签，同时希望在预览源文本时自动生成文档的概览、关键字等分析结果。直接通过全文提问提取摘要会消耗较多token，且效果不一定理想。 可能原因 未通过提示词配置实现针对单个文件的摘要…
故障排查GitHub Issue
解决FastGPT知识库引用模板保存后未生效的问题
解决FastGPT知识库引用模板保存后未生效的问题 现象 在FastGPT的高级编排页面中，选择知识库引用的非默认模板，点击保存按钮后，返回对话界面并查看详情，当前使用的引用提示模板仍为默认的第一个模板。该问题出现在4.7.1版本中。 可能原因 当前公开issue未明确标注该问题的具体触发原因，需结合实际部…
故障排查GitHub Issue
FastGPT密钥异常与上传文件问题排查方法
FastGPT密钥异常与上传文件问题排查方法 现象 用户在使用FastGPT公有云或私有部署版本过程中出现异常，场景涉及密钥配置与上传文件操作。其中上传的文件仅包含两行内容，无大数据量相关问题。用户已确认自身使用的密钥可正常使用。 可能原因 异常可能与所使用的密钥配置或可用性相关，未查看系统运行日志也可能导…
故障排查GitHub Issue
解决FastGPT知识库应用构建的相关配置与实现问题
解决FastGPT知识库应用构建的相关配置与实现问题 现象 用户提交的issue仅完成例行检查项，具体包括确认当前无类似issue、已完整查看项目README与文档、确认自有key可正常使用、愿意跟进issue协助测试与反馈，同时认可维护者精力有限，不遵循规则的issue可能被无视或直接关闭的说明。用户选择…