故障排查GitHub Issue
FastGPT知识库Markdown格式图片无法显示的解决方法
FastGPT知识库Markdown格式图片无法显示的解决方法 现象 FastGPT私有部署最新版中，手动添加至知识库的Markdown格式图片无法正常显示，但同知识库中的Markdown格式URL可以正常使用，调试场景下可正常回复URL内容但无法回复图片内容。 可能原因 需按实际环境确认。 排查步骤 1.…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查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…
故障排查GitHub Issue
FastGPT合并插件无法正常使用的排查与解决方法
FastGPT合并插件无法正常使用的排查与解决方法 现象 FastGPT 4.8.1私有部署版本中，合并插件无法正常使用。需调整接口数据格式以适配插件要求，对数据中的ID、name字段填写及数组内容存在疑问，可将HTTP获取或代码运行得到的信息传入AI提示词或文档引用。 可能原因 传入合并插件的接口数据格式…
故障排查GitHub Issue
解决FastGPT消息卡片表单与流程交互配置问题
解决FastGPT消息卡片表单与流程交互配置问题 现象 用户在FastGPT的流程和插件中添加消息卡片后，希望实现卡片内表单与流程的交互应答功能，同时支持消息卡片的可视化编辑、编写js/css/html代码及传参。例如希望将预订咖啡的提示信息以卡片形式展示供用户选择，当前无法实现该卡片交互与流程的联动，无法…
故障排查GitHub Issue
FastGPT百万级知识库导入速度变慢的排错指南
FastGPT百万级知识库导入速度变慢的排错指南 现象 私有部署版本为V4.6.9，采用docker-compose部署。知识库导入量较小时，1万条数据可在几分钟内完成导入，3090显卡上的m3e-base向量接口功耗约50%。当知识库已导入量达到百万条时，1万条新数据导入耗时超过1小时。此时MongoDB…