更新时间:2026-11-03 GMT+08:00
分享

HTTP

HTTP节点用于在工作流中调用外部服务的API接口,支持POST、GET、PUT、DELETE请求。通过该节点,可以向指定的服务器地址发送请求,获取数据或提交信息,从而将工作流与外部系统打通,实现查询第三方平台的信息、向业务系统写入处理结果、调用外部模型服务等功能。

HTTP请求节点的核心能力:

  • 调用外部API:向支持HTTP协议的服务发送请求,获取或提交数据。
  • 动态参数拼接:请求参数、请求体中的内容均可以引用上游节点的输出,实现根据实际数据动态构建请求。

前提条件

已构建工作流。

约束限制

  • 不支持流式接口。
  • 域名参数、请求路径需填写为固定值,不支持动态引用变量。
  • HTTP请求节点调用的API响应时间不能超过100秒。

配置HTTP节点

  1. 在工作流编排画布中,单击“添加节点”按钮,从节点列表中选择“HTTP”,即可将该节点添加至当前工作流编排画布中。

    图1 添加HTTP节点

  2. 单击“HTTP”节点,在弹出的节点详情页面中进行参数配置,参考表1。

    图2 配置HTTP请求节点
    表1 HTTP请求节点参数说明

    参数名称

    参数说明

    API

    用于指定请求的方法和目标地址,决定“向哪里发送什么类型的请求”。

    API配置包含“请求方式”和“URL”:

    • 请求方式:选择HTTP请求的方法。GET:从外部服务获取数据,适用于查询类操作。POST:向外部服务提交数据,适用于创建、更新类操作。PUT:向外部服务提交数据,适用于更新类操作。DELETE:向外部服务删除数据,适用于删除类操作。
    • URL:请求目标服务器的域名地址(如https://api.example.com)和具体接口路径(如 /v1/chat/completions)。此参数为固定值,不支持动态引用变量。

    超时时间:API读取超时时间,最大值100秒。

    Headers请求参数

    请求头用于携带请求的附加元信息,例如指定数据格式(Content-Type)、标识客户端类型(User-Agent)等。大多数API都要求在请求头中传递特定的字段。

    最多支持配置20个Header请求参数。

    请求参数支持引用和值两种传参方式。

    • 引用:选择工作流中前置节点的输出值。适用于参数值需要随工作流运行动态变化的场景。
    • 值:自定义填写固定值。适用于参数值固定不变的场景。

    Params请求参数

    请求参数是附加在URL末尾的键值对(如 ?keyword=手机&page=1),用于向服务器传递查询条件或筛选信息。

    最多支持配置50个Params个数。

    请求参数支持引用和值两种传参方式。

    • 引用:选择工作流中前置节点的输出值。适用于参数值需要随工作流运行动态变化的场景。
    • 值:自定义填写固定值。适用于参数值固定不变的场景。

    Body请求参数

    请求体是HTTP请求中携带的数据内容,通常在API请求中用于向服务器提交结构化数据。支持none和raw两种配置模式:

    • none:不携带请求体。通常用于GET请求,或不需要提交数据的场景。
    • raw:以json格式编写请求体。可通过{{变量名}}引用输入参数实现动态拼装。引用字符串类型的变量时,需在变量外额外添加引号。

    body体最大支持58MB。

    输出

    HTTP请求执行完成后,系统会按照用户定义的输出对象格式将响应体进行反序列化,供下游节点引用:

    输出:请谨慎填写输出内容,与HTTP实际输出参与保持一致,HTTP服务端调整后请保证决策流输出内容同步修改。

  3. 单击上方的“保存”。

相关文档