HTTP请求

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

节点说明

HTTP请求节点允许用户通过HTTP协议与外部服务进行数据交互，支持多种请求方法和详细的配置选项（如请求参数、请求头、鉴权信息和请求体），确保请求的可靠性和数据的准确处理。

配置HTTP请求节点

登录AgentArts智能体开发平台，在左侧导航栏“个人空间”区域，选择目标空间。
单击左侧导航栏“开发中心 > 智能体管理 ”，单击左上角“工作流”页签，进入工作流应用管理界面，单击您创建的工作流。
单击“添加节点”并选择“HTTP请求”节点。

单击画布中已添加的“HTTP请求”节点，参照表1，完成HTTP请求节点的配置。

单击图标，可修改卡片节点名称，修改完成后单击空白区域进行保存。
单击图标，可重命名HTTP节点名称，复制一个卡片节点或删除卡片节点；也可以将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，可使用“{”引用输入参数变量，字符串类型无需额外添加引号说明类型信息。
	输出参数	定义HTTP请求成功后返回的数据结构，以便在后续节点中使用这些数据。 body：HTTP响应的主体内容，通常为字符串类型。可以是JSON、XML或其他格式的数据。 status_code：HTTP响应的状态码，表示请求的结果状态，如200表示成功，404表示未找到等。 headers：HTTP响应的头信息，通常为字符串类型，包含响应的各种元数据。 error_message：当请求失败时返回的错误信息，帮助用户了解失败的原因。
鉴权方式	无需鉴权	请求不需要额外鉴权信息时选择此配置。
鉴权方式	API Key	自定义鉴权，支持配置认证键和认证值，可选择将认证信息添加到请求头或请求参数中。在调用API时提供一个唯一的API Key进行鉴权。需配置以下信息需填写传入方式、参数名称和参数值。Agent在发起请求时，会自动把这个API Key塞到请求的Header（请求头）或Query（URL参数）中。传入方式：密钥是从Header中读取还是从Query中读取。参数名称：API Key的鉴权参数名称。参数值：API Key的具体值。关于密钥加密：鼠标移动至“参数值”右侧的上，可参看密钥的加密方式。平台默认使用KMS加密 + 默认密钥方式对认证密钥进行加密存储，防止信息泄露。加密机制：使用用户选择的密钥派生DEK进行加密，默认密钥为kms-agentarts/default。费用说明：实例不收费，每月提供20,000次免费调用次数。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考更换密钥的加密方式。
异常忽略配置	异常忽略	支持异常忽略功能。开启此功能后，如果试运行工作流时此节点运行失败，工作流不会中断，而是继续运行后续下游节点。如果下游节点引用了此节点的输出内容，则使用此节点预先配置的默认输出内容。