故障排查GitHub Issue
解决FastGPT知识库文件级元信息配置与搜索召回问题
解决FastGPT知识库文件级元信息配置与搜索召回问题 现象 用户希望在FastGPT知识库的文件级别设置元信息（如文件名、作者）作为搜索召回依据，当前通过API修改或页面单条修改数据索引的操作效率较低。 可能原因 当前FastGPT未提供便捷的知识库文件级元信息批量配置入口，仅支持单条修改或API调用，导…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT应用中知识库内容意外污染正常对话的问题
解决FastGPT应用中知识库内容意外污染正常对话的问题 现象 在FastGPT应用中添加包含特定配置信息的知识库并关联至应用后，发送简单无明确指向的输入（如“1”）时，AI会直接提取知识库中的内容进行回复，不会针对输入生成对应回应。例如知识库内容为“苹果18的配置：3000毫安时、18寸 LCD屏幕、IO…
故障排查GitHub Issue
解决FastGPT知识库引用文本加工自定义提取Q或A内容的问题
解决FastGPT知识库引用文本加工自定义提取Q或A内容的问题 现象 在FastGPT知识库搜索后，将知识库引用应用于文本加工环节时，无法自定义引用的输出格式，仅能使用默认的完整问答结构。相关使用场景包括检索知识相关度较低时提取Q作为参考列表，以及知识查重等场景，现有功能无法满足仅提取Q或A单独文本内容的需…
故障排查GitHub Issue
解决FastGPT知识库引用参数类型配置异常问题
解决FastGPT知识库引用参数类型配置异常问题 现象 在使用FastGPT知识库引用功能时出现异常，无法正常完成知识库关联或调用操作。具体异常表现需按实际环境确认。 可能原因 核心原因为知识库引用参数的格式与元素类型不符合系统要求。FastGPT要求知识库引用参数必须为数组类型，且数组内仅支持string…
故障排查GitHub Issue
解决FastGPT知识库引用内容显示异常的问题
解决FastGPT知识库引用内容显示异常的问题 现象 在FastGPT 4.9.7-fix版本中，将知识库召回的信息通过脚本处理后仅保留指定数据集分片内容，将处理后的信息放入AI的system或user提示词。例如，知识库召回3.xls和333doc.docx两个数据集，脚本处理后仅保留3.xls的数据集分…
故障排查GitHub Issue
FastGPT知识库检索超时问题的排查与优化方案
FastGPT知识库检索超时问题的排查与优化方案 现象 知识库检索耗时超过100秒，最高达130多秒，其他模块运行正常。将知识库检索所用模型切换为3.5-16k后，检索时间回归至3秒左右，但仍偶发检索超时问题。 可能原因 1. pgvector相关配置参数不合理，尤其是hnsw索引配置或内存交换设置。 2.…
故障排查GitHub Issue
解决FastGPT知识库搜索引用返回长度不一致且无法配置的问题
解决FastGPT知识库搜索引用返回长度不一致且无法配置的问题 现象 知识库搜索相关场景的引用返回上限存在不一致问题。简单模式、高级编排与搜索测试的可配置大小各不相同，且无法在配置文件中找到可修改对应参数的字段。模型设置的maxToken参数仅会影响上传与测试环节的上限，无法作用于引用上限。例如将maxTo…
故障排查GitHub Issue
FastGPT 知识库搜索参数由用户输入的历史需求
FastGPT 知识库搜索参数由用户输入的历史需求 适用场景与历史记录 原议题希望把最低相似度和检索方式等搜索参数暴露给聊天用户。 原始讨论提交于 2025-06-24，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 原线程记录的是输入方式需求。检索 API 的参数能力和工作流编辑器的变量绑定入…
故障排查GitHub Issue
FastGPT 指定回复内容过长时的自动滚动历史反馈
FastGPT 指定回复内容过长时的自动滚动历史反馈 适用场景与历史记录 原报告把知识库搜索结果经 JS 处理后直接输出到指定回复，连续查询时需要手动滚动。 原始讨论提交于 2024-06-04，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 维护者确认一次内容过长、超出可滚动区域时会出现该表现…
故障排查GitHub Issue
解决FastGPT知识库导入后相似度计算数值异常问题
解决FastGPT知识库导入后相似度计算数值异常问题 现象 用户在FastGPT中导入知识库后，执行相似度计算得到的数值为100、200多，未处于0到1的常规正常区间，该数值未符合相似度计算的标准输出范围，本次问题场景中使用的embedding模型为m3e-large。 可能原因 未对相似度计算结果进行归一…
故障排查GitHub Issue
解决FastGPT知识库搜索相似度数值异常偏高问题
解决FastGPT知识库搜索相似度数值异常偏高问题 现象 本地部署FastGPT后，在知识库内执行搜索测试时，返回的单条结果相似度数值达到276.6083。在线使用版本的搜索结果相似度均控制在1以内。 可能原因 用于生成向量的embedding模型未执行归一化处理，导致相似度计算结果超出合理范围。 排查步骤…
故障排查GitHub Issue
解决FastGPT知识库回答无法关联原始源文档的问题
解决FastGPT知识库回答无法关联原始源文档的问题 现象 使用FastGPT知识库生成回答时，若回答不准确或不全面，无法跳转至原始源文档查看完整信息。当前知识库的提示词未与信息源建立关联。 可能原因 1. 现有知识库实现未将生成的回答内容与原始信息源建立关联； 2. 本地文件直接上传至知识库的场景下，未存…