一句话定义
本页内容针对FastGPT中HTTP工具的请求体(body)使用场景,以及相关的JSON解析错误、请求实体过大报错的说明,同时涵盖4.14.7版本的相关修复内容。
在 FastGPT 里怎么用
在FastGPT中创建HTTP工具时,可配置请求体(body)参数,若请求体包含变量,需确保参数格式符合JSON规范以避免解析错误。上传文件时,请求体(body)的大小若超出系统限制,会触发413 Request Entity Too Large报错。4.14.7版本修复了创建HTTP工具时body包含变量触发JSON解析错误的问题,同时优化了MCP暴露Agent时无法传入文件链接的相关场景,修复了工作流节点未捕获系统错误、切换Tab后画布自动定位失效等问题。
容易搞错的地方
创建HTTP工具时,未正确处理包含变量的请求体格式,导致JSON解析错误。上传大体积文件时,未意识到请求体超出系统限制会触发413 Request Entity Too Large报错,误判为其他类型的错误。使用MCP暴露Agent时,未正确配置请求体参数,导致无法传入文件链接。部分用户在配置工作流时,未注意工具名称不能以数字开头,导致调用失败。
来源: FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 术语表 场景。执行变更前,需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照,再执行最小验证场景。