故障排查官方文档7 分钟阅读问题清单聚合页

FastGPT Agent 与 MCP 问题清单:按症状分组

查阅FastGPT Agent 与 MCP 问题清单,按症状定位已发布的配置说明与排查条目,结合服务日志、依赖状态和版本要求逐项核对。

本页汇总站内已发布的 22 篇Agent 运行时与 MCP 工具接入环节的问题,按症状分组列出,可按报错表现直接定位到对应文档。

属于这一环节的三类典型症状

  1. Agent 返回空响应或中途停止
  2. MCP 工具列表拉取失败或工具调用不生效
  3. 工具参数传递与返回结构不符合预期

若症状与上述三类都不匹配,可返回部署与环境问题全景重新分流。

排查这一环节的通用顺序

  1. 取后端服务日志中与该环节组件相关的完整报错,包括组件名与错误码
  2. 在部署环境内验证该组件是否可独立访问,排除网络与权限因素
  3. 核对该组件的版本与主服务版本的对应关系
  4. 按下方清单中症状最接近的条目执行,完成后重新验证同一操作

已发布的文档清单(22 篇)

文档类型
FastGPT Agent Sandbox资源与生命周期配置参数说明术语速查
解决FastGPT 4.15版本OpenSandbox部署复杂的问题排错/错误码
解决FastGPT 4.7私有部署版本chatglm3-6b工具调用不生效问题排错/错误码
解决FastGPT使用vllm部署模型时工具调用参数异常问题排错/错误码
解决FastGPT插件SDK与v0.6.3版本上传接口不匹配问题排错/错误码
解决FastGPT私有部署4.8.9版本工具调用无聊天历史问题排错/错误码
解决FastGPT私有部署V4.8版本获取系统时间工具调用报错问题排错/错误码
解决FastGPT私有部署vllm工具调用参数格式不符问题排错/错误码
解决FastGPT私有部署工具调用Http模块流程调试失败问题排错/错误码
解决FastGPT私有部署版Gemini工具调用函数名校验报错排错/错误码
解决FastGPT私有部署版工具调用错乱与token超限问题排错/错误码
解决FastGPT私有部署版无参MCP工具调用报错问题排错/错误码
解决FastGPT私有部署版本工具调用第三次时的报错问题排错/错误码
解决FastGPT私有部署版本工具调用结果为空对象的问题排错/错误码
解决FastGPT私有部署版豆包模型工具调用失效的问题排错/错误码
解决FastGPT部署时sandbox服务配置不完整的启动问题排错/错误码
解决fastgpt-code-sandbox v4.15.0 seccomp加载失败启动异常问题排错/错误码
部署FastGPT OpenSandbox 自托管Agent沙盒环境部署场景
部署并配置FastGPT的OpenSandbox自托管Agent沙盒运行环境以满足自托管需求部署场景
配置FastGPT Agent Sandbox的资源占用上限与生命周期管理参数部署场景
配置FastGPT Agent Sandbox通用参数与部署步骤部署场景
配置FastGPT Agent Sandbox通用运行参数与部署步骤部署场景

这份清单的适用范围

清单中的条目来自可公开复现的情形,按症状归组。以下情形需要另行确认:

  • 同一症状由多个原因共同导致时,需按上述顺序逐项排除
  • 商业版特有配置项引发的同类症状
  • 与具体基础设施环境耦合、无法在标准部署下复现的情形

继续阅读

参考资料

问题仍未定位时

上述条目覆盖的是可依据公开信息复现与排查的情形。若问题涉及具体部署环境的配置细节、或需要结合运行日志逐项确认,可通过商务咨询获取部署阶段的技术支持;云服务形态可直接开始使用,不需要处理部署环节的环境依赖。

  • 商务咨询:获取私有部署与升级阶段的技术支持
  • 立即开始:使用云服务形态,跳过环境准备
  • 定价:对比云服务与私有部署两种形态的适用范围