故障排查GitHub Issue
解决FastGPT K8s部署pluginTemplates目录缺失问题
解决FastGPT K8s部署pluginTemplates目录缺失问题 现象 在Kubernetes环境部署FastGPT时，会出现pluginTemplates目录缺失的报错，导致服务无法正常加载模板资源。部分场景下即使Dockerfile中配置了复制该目录的指令，仍会触发该报错。此外，使用Helm方式…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查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可能被无视或直接关闭的说明。用户选择…
故障排查GitHub Issue
FastGPT知识库操作及导出功能常见问题排查指南
FastGPT知识库操作及导出功能常见问题排查指南 现象 用户反馈FastGPT存在以下使用场景的问题： 1. 知识库单条词条删除功能的使用疑问； 2. 希望实现知识库词条批量删除，但当前操作效率不足； 3. 缺少标准化的知识库分类管理功能； 4. 导出的CSV文件未包含来源列，无法溯源引用内容； 5. 导…
故障排查GitHub Issue
解决FastGPT知识库匹配后无法调用原生大模型的问题
解决FastGPT知识库匹配后无法调用原生大模型的问题 现象 需求为知识库存在匹配内容时按知识库回答，知识库无法检索到对应内容时调用原生大模型能力，该功能近期失效。例如询问天气时，流程始终停留在知识库匹配环节，无法跳转至原生大模型。删除全部知识库后，可正常调用原生大模型并返回正确结果。 可能原因 存在两种触…
故障排查GitHub Issue
解决FastGPT知识库上传后未配置模型的歧义与调用问题
解决FastGPT知识库上传后未配置模型的歧义与调用问题 现象 直接文档问答场景中，知识库上传文档后未配置问答模型，易引发歧义；使用提取QA、补充索引或自定义索引功能时，未配置模型会导致API调用需额外传递模型参数。 可能原因 未完成知识库对应功能的模型配置，包括问答模型、QA提取、补充索引及自定义索引所需…