故障排查GitHub Issue
解决FastGPT知识库搜索无法返回indexes元数据的问题
解决FastGPT知识库搜索无法返回indexes元数据的问题 现象 FastGPT知识库搜索返回的结果中，无法包含indexes元数据字段。当需要通过indexes字段匹配权限、过滤搜索结果时，当前仅能逐条调用http://localhost:3000/api/core/dataset/data/deta…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
解决FastGPT工作流AI对话插件提示词多行粘贴报错问题
解决FastGPT工作流AI对话插件提示词多行粘贴报错问题 现象 在FastGPT工作流内创建AI对话插件，输入2行以上提示词并保存刷新后，复制文本框内2行以上文本直接进行粘贴替换操作时，会触发报错：Lexical errror Error: Minified Lexical error #19; visi…
故障排查GitHub Issue
FastGPT集成外部LLM追踪平台的配置与排错方法
FastGPT集成外部LLM追踪平台的配置与排错方法 现象 配置外部LLM追踪平台后，可能出现以下异常：未捕获到LLM调用数据；团队级或系统级追踪配置未按预期覆盖应用级设置；多追踪平台同时配置时，数据未同时发送到所有目标平台；敏感应用未成功禁用追踪功能。 可能原因 1. 配置优先级未遵循App（开关） Te…
故障排查GitHub Issue
解决云端FastGPT无法调用本地或内网MCP工具的问题
解决云端FastGPT无法调用本地或内网MCP工具的问题 现象 云端部署的FastGPT无法调用本地或内网环境部署的MCP工具。当MCP Server运行在127.0.0.1或内网网段时，无法与云端FastGPT建立通信，导致无法使用SSH、本地系统命令、内网API、文件操作等本地工具能力。 可能原因 当前…
故障排查GitHub Issue
修复FastGPT中的Markdown格式异常问题
修复FastGPT中的Markdown格式异常问题 现象 使用FastGPT处理内容时，Markdown格式无法按照预期正常渲染，或出现显示错乱、样式失效的问题，影响内容的正常展示与使用。 可能原因 由于本次issue仅提及需要修复Markdown格式相关问题，未提供具体异常场景的细节，因此具体原因需按实际…
故障排查GitHub Issue
解决FastGPT上传文档时内嵌图片未转存数据库的问题
解决FastGPT上传文档时内嵌图片未转存数据库的问题 现象 用户使用FastGPT的API或手动上传Markdown文档时，文档内的Base64格式内嵌图片会被原封不动保留，未被转换为独立图片存储到数据库。这会导致文档分块后的块大小过大，产生过多无效索引，无法满足自定义分块的需求。 可能原因 当前Fast…
故障排查GitHub Issue
为FastGPT的MCP服务添加名称修改与安全认证功能
为FastGPT的MCP服务添加名称修改与安全认证功能 现象 FastGPT创建MCP服务后，服务名称会自动生成，格式为FastGPT-mcp-xxxxxxxxxxx。在其他平台调用该MCP服务时，仅能使用该自动生成的名称，无法自定义修改，不利于识别；同时MCP服务未内置Authorization: Bea…
故障排查GitHub Issue
解决FastGPT中MinerU Saas插件files参数配置问题
解决FastGPT中MinerU Saas插件files参数配置问题 现象 在FastGPT私有部署V4.14.20版本的对话Agent中，配置MinerU Saas解析插件的files参数时，在参数值输入框输入斜杠（/）后，无法弹出参数值来源选择列表，无法完成该参数的配置。 可能原因 暂无公开明确的触发原…
故障排查GitHub Issue
排查并解决FastGPT中MiniMax-H3模型与视频生成支持问题
排查并解决FastGPT中MiniMax-H3模型与视频生成支持问题 现象 在FastGPT中尝试调用MiniMax-H3模型生成视频时，无法正常使用该模型，无法满足制作文档过程中生成小视频讲解短片的需求，与issue中提及的应用场景一致。 可能原因 FastGPT当前版本未完成MiniMax-H3模型的适…
故障排查GitHub Issue
FastGPT MongoDB目录大量数据文件清理与排查方法
FastGPT MongoDB目录大量数据文件清理与排查方法 现象 用户在FastGPT部署环境中，发现MongoDB的数据目录下存在大量数据文件，需明确文件相关信息并完成清理操作。 可能原因 MongoDB会存储FastGPT运行产生的各类业务数据，随着系统运行时长增加、业务交互累积，数据会持续写入存储目…
故障排查GitHub Issue
解决FastGPT新增渠道时未添加模型无法搜索的问题
解决FastGPT新增渠道时未添加模型无法搜索的问题 现象 在FastGPT的「模型渠道 新增渠道」页面，未添加模型时无法使用模型搜索功能，仅能展示全量未筛选的模型列表，需向下滚动页面手动查找目标模型，操作流程较长。 可能原因 该页面的模型搜索功能与渠道已添加的模型配置绑定，未加入模型时搜索功能无法正常触发…
故障排查GitHub Issue
解决FastGPT开启模型思考模式后无思考过程输出的问题
解决FastGPT开启模型思考模式后无思考过程输出的问题 现象 用户在FastGPT 4.14.10私有部署版本中，已在模型配置页面开启思考模式，但在发起问答交互时，未输出对应的思考过程内容。 可能原因 由于本次issue未披露更多异常细节，可能的关联因素需结合实际部署环境确认，例如模型配置的思考模式参数未…