故障排查GitHub Issue
解决FastGPT知识库引用参数类型配置异常问题
解决FastGPT知识库引用参数类型配置异常问题 现象 在使用FastGPT知识库引用功能时出现异常，无法正常完成知识库关联或调用操作。具体异常表现需按实际环境确认。 可能原因 核心原因为知识库引用参数的格式与元素类型不符合系统要求。FastGPT要求知识库引用参数必须为数组类型，且数组内仅支持string…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查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. 本地文件直接上传至知识库的场景下，未存…
故障排查GitHub Issue
解决FastGPT知识库回复内容的来源视图构建与溯源问题
解决FastGPT知识库回复内容的来源视图构建与溯源问题 现象 使用FastGPT生成基于知识库的回复内容时，无法直接构建并展示回复中引用的知识库片段的来源视图，无法实现溯源到具体文档及对应片段的需求，无法满足知识库回复内容来源可视化的应用场景。用户希望在回复内容中明确标注所使用知识库片段对应的原始文档与具…
故障排查GitHub Issue
说明FastGPT知识库文件分割的具体实现策略
说明FastGPT知识库文件分割的具体实现策略 现象 使用者在使用FastGPT的知识库功能时，存在对文件分割策略的疑问，希望明确两种场景下的分割规则：一是使用大语言模型时的提示词构造方式，二是未使用大语言模型时的具体分割方式。 可能原因 使用者未掌握FastGPT知识库文件分割的两种实现模式，不清楚不同模…
故障排查GitHub Issue
解决FastGPT知识库中带合并单元格的表格识别异常问题
解决FastGPT知识库中带合并单元格的表格识别异常问题 现象 知识库中包含合并行、合并列（即rowspan、colspan属性）的表格，导入后内容出现错乱，或大模型无法正确理解该类表格的结构与内容。 可能原因 原始文档中的表格带有rowspan、colspan合并单元格属性，未经过正确格式转换就导入知识库…