故障排查GitHub Issue
FastGPT连接外部MongoDB实例超时问题排查与解决
FastGPT连接外部MongoDB实例超时问题排查与解决 现象 使用私有部署v4.8.11-fix版本的FastGPT，连接非本机的MongoDB数据库时出现超时错误。使用相同的docker-compose.yaml在本机部署时，可正常连接MongoDB，通过启动日志发现程序持续尝试连接名为"mongo"…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT应用中提取内容无法传递至指定回复的问题
解决FastGPT应用中提取内容无法传递至指定回复的问题 现象 在FastGPT中新建应用后，配置流程中添加将用户问题提取内容的步骤，并将该步骤关联至指定回复节点，此时指定回复区域显示为空，但系统已成功提取用户问题的内容。 可能原因 目前无公开的明确触发原因说明，需结合实际部署环境与应用配置流程进一步确认。…
故障排查GitHub Issue
FastGPT私有部署4.7.1版本上传文件集合接口404问题的排错方法
FastGPT私有部署4.7.1版本上传文件集合接口404问题的排错方法 现象 访问FastGPT向数据库上传文件集合的接口时，返回404错误。当前部署环境为私有部署版本4.7.1，且已确认使用的密钥可正常使用。 可能原因 可能的触发因素包括：后端服务未正常注册该接口的路由，服务启动时未加载相关功能模块，或…
故障排查GitHub Issue
FastGPT中文件集创建接口超时问题的排查与解决
FastGPT中文件集创建接口超时问题的排查与解决 现象 访问接口http://localhost:3002/api/core/dataset/collection/create/fileId时经常出现超时，且设置的超时时间未生效。 可能原因 仅修改局部超时配置但未覆盖目标接口的完整调用链路，或超时配置的位…
故障排查GitHub Issue
FastGPT私有部署4.8.9版本文件链接传递示例缺失排错
FastGPT私有部署4.8.9版本文件链接传递示例缺失排错 现象 使用FastGPT私有部署4.8.9版本时，需执行文件链接传递操作，但官方文档未提供该操作的相关示例，无法明确具体的实现方式与参数配置要求。 可能原因 需按实际环境确认，目前已知的相关官方文档未包含文件链接传递的示例内容，无明确的操作指引。…
故障排查GitHub Issue
实现FastGPT中基于用户问题首字母的分支调用功能
实现FastGPT中基于用户问题首字母的分支调用功能 现象 在FastGPT中实现基于用户输入问题首字母选择调用对应分支的功能时，首字母会干扰模型判断或知识库查询，需先对首字母进行处理。当前需通过HTTP模块完成该处理操作，流程繁琐且增加了外部依赖。 可能原因 当前FastGPT未内置轻量代码执行环境，无法…
故障排查GitHub Issue
解决FastGPT并发设为1后5刀号429及知识库集合异常问题
解决FastGPT并发设为1后5刀号429及知识库集合异常问题 现象 将FastGPT的并发参数全部设置为1后，使用5刀号密钥仍返回429错误。OneAPI面板日志显示FastGPT已成功调用模型，知识库生成70+条索引，但等待就绪后知识库集合仍显示为0。 可能原因 目前无官方明确说明，仅可基于现象推测可能…
故障排查GitHub Issue
解决FastGPT对接第三方服务时的换行符二次转义问题
解决FastGPT对接第三方服务时的换行符二次转义问题 现象 使用FastGPT对接智能微秘书服务时，微信端接收的回复内容中出现\n\n格式的换行符，存在二次转义问题。直接测试对接One-API时返回内容正常，经FastGPT转接后出现该异常。 可能原因 该问题由FastGPT在将One-API的返回内容转…
故障排查GitHub Issue
解决FastGPT应用标题需等待首轮对话后才更新的问题
解决FastGPT应用标题需等待首轮对话后才更新的问题 现象 FastGPT 4.8.9私有部署版本中，应用标题未在页面初始加载时显示，需等待第一轮对话结束后才会更新为目标标题。 可能原因 相关具体原因未在issue中明确，需按实际环境确认，可能与应用标题的渲染逻辑、数据加载触发时机有关。 排查步骤 1.…
故障排查GitHub Issue
解决FastGPT中工具调用结果过长自动隐藏的问题
解决FastGPT中工具调用结果过长自动隐藏的问题 现象 工具调用返回结果过长时自动被隐藏，工具调用结果为JSON格式，隐藏后内容不完整，影响完整查看工具返回的信息。 可能原因 该问题的具体触发逻辑需按实际部署环境确认，暂无公开的官方配置说明可直接对应该问题，目前已知与工具调用返回内容的展示限制相关。 排查…
故障排查GitHub Issue
解决FastGPT中toolChoice和functionCall设为false时误触发文档解析的问题
解决FastGPT中toolChoice和functionCall设为false时误触发文档解析的问题 现象 私有部署版本4.8.9 main分支的FastGPT中，将toolChoice和functionCall参数均设置为false时，提交纯文字提问，问答流程仍会执行文档解析功能，该问题导致问答流程不符…
故障排查GitHub Issue
解决FastGPT添加知识库后模型未严格遵循知识库内容的问题
解决FastGPT添加知识库后模型未严格遵循知识库内容的问题 现象 添加知识库后，模型回复包含非知识库来源的额外逻辑。使用编排功能将AI对话替换为指定回复时，回复内容出现异常。相关截图显示该问题在配置调整后仍存在。 可能原因 需按实际环境确认，常见关联因素包括模型提示词的约束配置、知识库的召回规则设置、编排…