故障排查GitHub Issue
解决FastGPT多Pod部署场景下SSE会话不连贯问题
解决FastGPT多Pod部署场景下SSE会话不连贯问题 现象 在FastGPT 4.9.6私有部署多Pod的mcpserver场景中，使用SSEServerTransport时，当负载均衡将初始SSE请求与后续POST请求分发到不同Pod，会出现请求挂起直至超时的问题，会话连贯性被破坏。 可能原因 系统将…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT多工具调用后续工具无法获取前序数据的问题
解决FastGPT多工具调用后续工具无法获取前序数据的问题 现象 在FastGPT 4.12.0私有部署版本中，用户配置了两个工具：知识库查询工具与统计图表绘制工具。用户希望先调用知识库工具获取业务数据，再将查询得到的数据传入图表工具生成统计结果，但当前两个工具可被同时触发调用，然而图表工具无法获取到知识库…
故障排查GitHub Issue
解决FastGPT多工具场景下默认调用指定知识库的问题
解决FastGPT多工具场景下默认调用指定知识库的问题 现象 用户在FastGPT中搭建多工具搭配单个知识库的应用，期望当用户提问无匹配的工具时，自动调用知识库检索并生成回答。但实际使用中，知识库工具的调用不稳定，时而成功调用时而无法触发。用户曾在知识库工具的描述中添加“找不到合适工具时，请使用这个工具检索…
故障排查GitHub Issue
FastGPT多轮对话接口调用参数选择与使用说明
FastGPT多轮对话接口调用参数选择与使用说明 现象 用户基于FastGPT开发应用并对接前端时，对多轮对话的接口传参方式存在疑问。用户发起第一轮对话时传入chatId为9999、单条用户消息“你好”，在第二轮对话时，不确定是仅传入当前用户消息“我刚刚问了啥”与chatId9999，还是需要传入包含完整历…
故障排查GitHub Issue
FastGPT多模态API传入base64图片报错的排查与解决方法
FastGPT多模态API传入base64图片报错的排查与解决方法 现象 使用FastGPT的多模态模型应用开放API访问时，传入base64格式图片发起请求，会返回如下报错： 可能原因 根据报错信息，问题源于FastGPT识别传入的图片数据为无效URL。可能的原因包括：传入的base64图片未按照标准da…
故障排查GitHub Issue
解决FastGPT多模态API图文关联丢失与assistant消息过滤问题
解决FastGPT多模态API图文关联丢失与assistant消息过滤问题 现象 用户调用FastGPT多模态API时，若通过content有序数组格式传输图文混合消息，FastGPT内部会自动将所有图片资源前置，并将数组内所有文本内容合并为单一段落，导致图文关联丢失。同时，消息体中的assistant角色…
故障排查GitHub Issue
解决FastGPT中添加多个ECharts配置引发页面崩溃的问题
解决FastGPT中添加多个ECharts配置引发页面崩溃的问题 现象 在FastGPT平台中，当添加超过三个ECharts可视化配置时，会触发页面崩溃问题。具体表现为完成第三个ECharts配置的添加后，页面无法正常加载或直接无响应。本次用户测试的三个配置分别为时间趋势图、平台对比图、地域分布图的ECha…
故障排查GitHub Issue
解决FastGPT多线程使用同一API key访问应用报错问题
解决FastGPT多线程使用同一API key访问应用报错问题 现象 多线程使用同一个API key同时访问FastGPT应用时，应用出现报错。直接使用相同程序访问大模型原生接口，返回结果正常。FastGPT服务日志中会出现[ERROR] sse error: Premature close报错，错误栈信息…
故障排查GitHub Issue
解决FastGPT初始化数据库时MySQL 1045访问被拒绝的问题
解决FastGPT初始化数据库时MySQL 1045访问被拒绝的问题 现象 部署后服务多次尝试启动均失败，日志中重复出现固定报错：failed to initialize database, got error Error 1045 (28000): Access denied for user 'root…
故障排查GitHub Issue
解决FastGPT私有部署中MySQL容器启动失败的问题
解决FastGPT私有部署中MySQL容器启动失败的问题 现象 在WSL Ubuntu22.04.3环境中，通过docker compose快速部署FastGPT时，MySQL容器无法正常启动，部署流程卡在容器启动环节。用户提供的报错截图显示MySQL启动存在异常，但未直接给出具体报错文本，仅通过修改镜像版…
故障排查GitHub Issue
FastGPT配置n1n API时的常见问题排查与解决
FastGPT配置n1n API时的常见问题排查与解决 现象 用户在FastGPT中配置n1n API作为大语言模型提供商时，可能出现无法加载可用模型列表、调用模型时返回认证失败或连接超时等报错。 可能原因 可能的异常原因包括：配置的n1n API密钥无效或未获得对应模型的访问权限；填入的基础URL与官方要…
故障排查GitHub Issue
解决FastGPT的neapi服务因MySQL 1130错误重启的问题
解决FastGPT的neapi服务因MySQL 1130错误重启的问题 现象 FastGPT的neapi服务持续处于重启状态，查看服务日志可发现循环重复以下内容： - 打印failed to initialize database, got error Error 1130: Host '172.19.0.…