HTTP请求节点
HTTP请求节点允许用户通过 HTTP 协议发送请求到外部服务,实现数据的获取、提交和交互。支持多种 http 请求方法,并允许用户配置请求参数、请求头、鉴权信息、请求体等,以满足不同的数据交互需求。此外,HTTP请求节点还提供了异常忽略功能保证API服务异常情况下工作流正常执行。HTTP节点区别于插件节点,大部分参数如路径、请求参数、请求头等信息都支持动态配置。API当前仅支持GET/POST请求,支持api-key认证鉴权方式,不支持流式接口。
HTTP请求节点为可选节点,若无需配置,可跳过该步骤。
HTTP请求节点配置步骤如下:
- 单击画布下方“添加节点”按钮,在节点抽屉中拖动“HTTP请求”节点至画布中,单击该节点以打开节点配置页面。
- 参照表1,完成HTTP请求节点的配置。
表1 HTTP请求节点配置说明 配置类型
参数名称
参数说明
API配置
请求方式
支持以下请求方法:
GET:用于请求从外部服务获取数据。
POST:用于向服务器提交数据。
域名
请求地址的服务器域名,此域名不支持动态指定参数。
路径
请求地址的实际路径,支持动态指定参数,可通过“{}”方式动态引用输入参数的值。
参数配置
输入参数
输入参数支持在路径或请求体中动态指定参数,支持引用和输入两种类型:
- 类型、值:支持“引用”和“输入”两种类型。
- 引用:支持用户选择工作流中已包含的前置节点的输出变量值。适用于路径或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请求节点配置示例
- 节点配置完成后,单击“确定”。
- 连接HTTP请求节点和其他节点。