更新时间:2025-11-26 GMT+08:00
分享

HTTP请求节点

HTTP请求节点允许用户通过 HTTP 协议发送请求到外部服务,实现数据的获取、提交和交互。支持多种 http 请求方法,并允许用户配置请求参数、请求头、鉴权信息、请求体等,以满足不同的数据交互需求。此外,HTTP请求节点还提供了异常忽略功能保证API服务异常情况下工作流正常执行。HTTP节点区别于插件节点,大部分参数如路径、请求参数、请求头等信息都支持动态配置。API当前仅支持GET/POST请求,支持api-key认证鉴权方式,不支持流式接口。

HTTP请求节点为可选节点,若无需配置,可跳过该步骤。

HTTP请求节点配置步骤如下:

  1. 单击画布下方“添加节点”按钮,在节点抽屉中拖动“HTTP请求”节点至画布中,单击该节点以打开节点配置页面。
  2. 参照表1,完成HTTP请求节点的配置。
    表1 HTTP请求节点配置说明

    配置类型

    参数名称

    参数说明

    API配置

    请求方式

    支持以下请求方法:

    GET:用于请求从外部服务获取数据。

    POST:用于向服务器提交数据。

    域名

    请求地址的服务器域名,此域名不支持动态指定参数。

    路径

    请求地址的实际路径,支持动态指定参数,可通过“{}”方式动态引用输入参数的值。

    参数配置

    输入参数

    输入参数支持在路径或请求体中动态指定参数,支持引用和输入两种类型:

    • 参数名称:只允许输入字母、数字、下划线,且不能以数字开头。不支持特殊名称headers和query。

    • 类型、值:支持“引用”和“输入”两种类型。
      • 引用:支持用户选择工作流中已包含的前置节点的输出变量值。适用于路径或body参数需要动态配置的场景。
      • 输入:支持用户自定义取值。适用于路径或body参数需要固定配置便于修改的场景。

    示例:

    API功能为请求模型非流式接口,为实现动态更新用户输入目的,配置输入引用参数。

    输入参数键名为content,值引用自开始节点输出参数query。

    请求body为:

    {
        "messages": [
            {
                "role": "user",
                "content": {{content}}
            }
        ],
        "stream": false
    }

    请求参数

    请求参数是附加在 URL 后面的键值对,用于向服务器传递额外的信息。例如,在搜索请求中,可以通过请求参数传递搜索关键词。

    • 参数名称:只允许输入字母、数字、下划线,且不能以数字开头。

    • 类型、值:支持“引用”和“输入”两种类型。
      • 引用:支持用户选择工作流中已包含的前置节点的输出变量值。适用于请求参数值由前置节点生成场景。
      • 输入:支持用户自定义取值。适用于固定请求参数值场景。

    请求头

    请求头包含客户端的信息,如 User-Agent、Accept 等。通过配置请求头,可以指定客户端的类型、接受的数据格式等信息。

    • 参数名称:只允许输入字母、数字、下划线,且不能以数字开头。

    • 类型、值:支持“引用”和“输入”两种类型。
      • 引用:支持用户选择工作流中已包含的前置节点的输出变量值。适用于请求头值由前置节点生成场景。
      • 输入:支持用户自定义取值。适用于固定请求头值场景。

    请求体

    请求体是 HTTP 请求体中包含的数据,当前支持none和json两种配置模式。

    • none:无需配置请求体,通常用于GET请求
    • json:支持配置请求体json,可使用“{{}}”引用输入参数变量,字符串类型无需额外添加引号说明类型信息。

    鉴权方式

    无需鉴权

    请求不需要额外鉴权信息时选择此配置。

    API Key

    自定义鉴权,支持配置认证键和认证值,可选择将认证信息添加到请求头或请求参数中。

    异常忽略配置

    异常忽略

    支持异常忽略功能。开启此功能后,如果试运行工作流时此节点运行失败,工作流不会中断,而是继续运行后续下游节点。如果下游节点引用了此节点的输出内容,则使用此节点预先配置的默认输出内容。

    图1 HTTP请求节点配置示例
  3. 节点配置完成后,单击“确定”。
  4. 连接HTTP请求节点和其他节点。

相关文档