故障排查GitHub Issue
解决FastGPT中m3e模型知识库搜索相似度异常与排序问题
解决FastGPT中m3e模型知识库搜索相似度异常与排序问题 现象 使用m3e模型进行FastGPT知识库搜索测试时，返回结果的相似度数值高达500多，正常参考范围应为1以下；且相似的查询匹配结果未按照相似性排序，相同问题的匹配答案排列位置靠后。 可能原因 当前m3e模型生成的向量未经过归一化处理，导致相似…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
手动录入FastGPT问答对时自定义来源字段的方法
手动录入FastGPT问答对时自定义来源字段的方法 现象 手动录入问答对时，来源字段显示为固定的"手动录入"，无法设置为自定义内容，例如转录的来源网址，无法满足数据库质量相关的录入需求。 可能原因 当前系统的手动录入问答对功能中，来源字段被预设为固定值"手动录入"，未提供自定义编辑的入口或配置项，无法直接修…
故障排查GitHub Issue
FastGPT 检索后由用户确认引用范围的历史需求
FastGPT 检索后由用户确认引用范围的历史需求 适用场景与历史记录 原议题希望在知识库检索与 AI 回答之间，让用户手动排除不需要的引用集合。 原始讨论提交于 2024-08-13，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 这是检索后的交互确认需求。预检索过滤和检索后确认应分别设计。…
故障排查GitHub Issue
FastGPT知识库Markdown格式图片无法显示的解决方法
FastGPT知识库Markdown格式图片无法显示的解决方法 现象 FastGPT私有部署最新版中，手动添加至知识库的Markdown格式图片无法正常显示，但同知识库中的Markdown格式URL可以正常使用，调试场景下可正常回复URL内容但无法回复图片内容。 可能原因 需按实际环境确认。 排查步骤 1.…
故障排查GitHub Issue
解决FastGPT增强PDF解析中marker镜像CPU启动失败问题
解决FastGPT增强PDF解析中marker镜像CPU启动失败问题 现象 使用FastGPT的增强PDF解析功能时，marker镜像未正确启动，无法正常完成PDF解析任务。该问题出现在集成显卡无法被系统正确识别的环境中。 可能原因 集成显卡未被系统正确识别，导致marker镜像无法正常加载或启动。由于ma…
故障排查GitHub Issue
解决FastGPT中自动记录未匹配知识库聊天内容的问题
解决FastGPT中自动记录未匹配知识库聊天内容的问题 现象 用户希望实现自动记录未匹配知识库的用户提问，以辅助完善知识库，但无法完成该功能配置或获取对应记录。 可能原因 1. 无法自动区分模型未理解提问与知识库无匹配内容的场景，难以精准判定未匹配情况。 2. 全自动记录会包含大量测试类无效数据，缺乏筛选机…
故障排查GitHub Issue
解决FastGPT中LLM返回的数学公式与化学式渲染异常问题
解决FastGPT中LLM返回的数学公式与化学式渲染异常问题 现象 在FastGPT前端页面，LLM返回的数学公式与化学式无法被正确解析和渲染，影响相关知识解答场景。当跳过知识检索直接调用LLM时，公式渲染可恢复正常。 可能原因 1. LLM未按照提示要求为数学公式、化学式添加正确的包裹符； 2. 知识库内…
故障排查GitHub Issue
FastGPT 旧版 QA maxContext 调整后导入无分块的排查
FastGPT 旧版 QA maxContext 调整后导入无分块的排查 适用场景与历史记录 2024 年的报告描述将旧 config.json 中 maxContext 设为 32000 后导入很快结束却没有分块，改回 16000 时出现队列。 原始讨论提交于 2024-01-22，本页按该记录说明症状或…
故障排查GitHub Issue
解决FastGPT环境下MCP工具的接入与配置相关问题
解决FastGPT环境下MCP工具的接入与配置相关问题 现象 在FastGPT中尝试接入MCP工具时，无法直接通过工作流工具箱添加自定义MCP工具；通过工作流插件接入MCP服务器时，因MCP服务缺乏版本控制与热插拔能力，无法适配系统级插件的使用需求。 可能原因 MCP协议本身设计较为简单，未提供版本控制与热…
故障排查GitHub Issue
解决FastGPT中MCP配置更新后关联应用未同步的问题
解决FastGPT中MCP配置更新后关联应用未同步的问题 现象 开发MCP服务器修改后，在FastGPT点击"解析"并保存，MCP管理界面的内容会更新，但调用该MCP的应用未同步更新。存在两类典型场景：1. 修改MCP工具的说明内容，解析保存后管理界面更新，但已有的简易应用的工具调用界面中该工具说明未更新，…
故障排查GitHub Issue
解决FastGPT工作流中MCP协议相关功能的使用问题
解决FastGPT工作流中MCP协议相关功能的使用问题 现象 在FastGPT工作流中使用MCP协议节点或工具插件时，发现功能内容简单，效果未达预期。 可能原因 MCP协议相关功能当前偏向本地接入场景，云端聚合生态与自建HTTP插件无明显差异，且功能基础。 排查步骤 1. 确认已将FastGPT升级至最新版…
故障排查GitHub Issue
解决FastGPT知识库上传MD文档自动分段导致碎片化的问题
解决FastGPT知识库上传MD文档自动分段导致碎片化的问题 现象 上传MD文档至FastGPT知识库后，文档被自动分段，未按照设置的最大分块长度进行分段，导致内容碎片化严重。在RAG问答环节，常出现信息缺失的情况。部分用户反馈自定义分隔符配置后，出现合并多个段落或从段落中间分割的问题。 可能原因 Fast…