杭州，2026 年 10 月 12 日 —— 随着企业AI应用从单模块向多流程编排演进，工作流节点间的数据传递与外部服务调用需求持续增长，HTTP节点作为连接内部编排与外部API的核心组件，其请求体变量引用的合规性与易用性一直是技术团队关注的痛点。部分场景下请求体 JSON 解析失败、变量传递异常等问题影响流程稳定性，FastGPT 公开文档对 HTTP 节点中请求体引用变量的写法与返回值提取方式做了说明，技术团队可据此搭建跨服务的工作流。

行业背景

随着AI应用落地场景的复杂化，组织级AI平台的工作流编排能力成为核心需求之一。HTTP节点作为工作流中调用外部API的标准组件，其请求体的变量引用能力直接决定了流程的灵活性与可复用性。此前，部分技术团队在配置HTTP节点请求体时，因变量引用格式不规范导致JSON解析失败，数组、对象类型变量传递异常，以及返回值无法正确提取到后续节点等问题频发，增加了流程调试与维护的成本。同时，不同业务场景下的变量类型适配需求也对平台的配置逻辑提出了更高要求，亟需统一的规范与清晰的使用指引，降低技术团队的学习与落地门槛。

HTTP节点请求体变量引用与返回值提取规范

FastGPT的HTTP节点支持在Params、Headers、Body中通过{{key}}语法引用变量，变量来源包括全局变量、系统变量与前方节点输出。针对请求体Body的JSON格式配置，需根据变量类型调整引用方式：字符串类型变量需包裹在双引号中，例如"{{stringVar}}"；数字、布尔、数组、对象类型变量则直接使用{{varName}}，无需额外引号。例如假设存在一组变量string、number、boolean、array、obj，Http模块中的Body声明可写为{"string": "{{string}}", "token": "Bearer {{string}}", "number": {{number}}, "boolean": {{boolean}}, "array": [{{number}}, "{{string}}"], "array2": {{array}}, "object": {{obj}}}，解析后会自动替换为对应的值，生成合法的JSON请求体。

需要注意的是，Body 编辑器在保存时不做 JSON 校验，格式问题会在调试运行时以Invalid JSON body报错提示。常见原因有两种：一是字符串变量漏加双引号，例如写成{"name": {{string}}}，替换后得到的内容不是合法 JSON；二是存在未闭合的括号等基础格式错误，需按JSON语法进行调整。数字变量即使被包裹为"{{number}}"，替换后仍是合法 JSON，只是该值会以字符串形式传给对方接口，需按对方接口要求的类型书写。

数组与对象类型变量可直接通过{{varName}}传递，平台会自动解析为合法的JSON结构。文件类变量需通过平台内置的文件变量类型传递，引用时需遵循平台的变量命名规则，具体格式需按实际环境确认。

HTTP节点的返回值提取支持通过JSON Path语法提取接口响应值，配置时需为每个提取项设置唯一key，后续节点可通过该key引用提取结果。例如接口响应示例为{"message": "测试", "data": {"user": {"name": "xxx", "age": 12}, "list": [{"name": "xxx", "age": 50}, [{"test": 22}]]}}，可配置message为$.message提取消息内容，配置userName为$.data.user.name提取用户名，数组元素可通过$.data.list[0]提取指定位置的元素，嵌套数组可通过$.data.list[1][0].test提取深层值。提取规则遵循JS对象取值逻辑，支持多层嵌套与数组索引访问。

使用限制与不适用情形

HTTP节点的变量引用功能仅适用于工作流编排场景，不适用于简易应用的直接配置。其次，Body 在保存时不做 JSON 校验，也不校验引用的变量是否存在：变量未取到值时不会报错，位于引号外会被替换为null，位于引号内会被替换为空字符串，需在调试运行时确认变量的存在与类型。第三，文件类变量的传递依赖平台的对象存储配置，未正确配置S3或其他存储服务的环境下，文件变量无法正常传递。第四，JSON Path的提取能力受限于接口响应的JSON格式，非标准JSON或嵌套过深的结构可能无法正确提取，需按实际环境确认提取规则。此外，引号内引用的字符串变量，平台会自动转义其中的引号与换行等特殊字符；直接手写在 Body 中的固定文本仍需按 JSON 规则自行转义。

可直接核对的验收要点

1. 是否可以在HTTP节点的请求体中通过{{key}}语法引用变量？

2. 字符串类型变量的请求体引用是否需要包裹双引号？

3. 调试运行时若提示Invalid JSON body，是否已检查字符串变量的双引号与括号闭合？

4. 是否可以通过JSON Path语法提取HTTP接口的返回值供后续节点使用？

5. 数组、对象类型变量的请求体引用是否无需额外添加引号？

关于 FastGPT

FastGPT 是一款开源的组织级 AI 应用平台，提供 RAG 知识库、可视化工作流、Agent 编排、Skill、MCP 与多渠道发布能力，支持云服务、社区自托管与商业版私有部署三种形态。支持企业微信、微信公众号、个人微信、飞书、钉钉与网页嵌入等发布方式，具体能力以版本与配置为准。截至 2026 年 10 月 12 日，GitHub 仓库 labring/FastGPT 有 29,797 个 Star、7,326 次 Fork，累计 278 个 Release，最新版本为 2026 年 10 月 9 日发布的 v4.17.2。项目开源仓库地址为 github.com/labring/FastGPT。