HTTP 请求节点
HTTP 请求节点
【HTTP 请求】节点用于在工作流或对话流智能体中，向外部服务或系统发送 HTTP 请求。
它支持常见的请求方法（GET、POST、PUT、DELETE 等），可灵活调用第三方 API、Webhook 或内部接口，实现与外部系统的数据交互。
通过配置请求地址、请求方法、请求头、请求体和参数映射，可让智能体在流程中动态地从外部系统获取数据或提交数据结果。
应用场景
HTTP 请求节点是工作流与外部系统通信的核心组件，常见于以下场景：
- 调用第三方 API（如天气查询、翻译接口、公司内部数据接口）；
- 连接 RPA、ERP、CRM 等业务系统；
- 触发自动化任务（如发消息、写入数据库、创建订单）；
- 接收参数并动态生成响应内容；
- 配合参数提取器节点，将自然语言指令转为 API 调用参数。
节点功能
HTTP 请求节点支持完整的 HTTP 调用配置，包括：
| 配置项 | 说明 |
|---|---|
| 请求方法 | 选择 GET、POST、PUT、PATCH、DELETE 等标准方法 |
| 请求 URL | 支持固定地址或动态变量（如 {{ api_url }}） |
| 请求头（Headers） | 设置请求头参数，如 Content-Type、Authorization 等 |
| 查询参数（Query Params） | 在 URL 上添加查询参数，可动态引用上游变量 |
| 请求体（Body） | 以 JSON、Form、Text 等格式传递请求数据 |
| 超时时间（Timeout） | 设置请求等待上限，防止长时间挂起 |
| 认证方式（Authentication） | 支持自定义 Token、Basic Auth、API Key 等多种认证方式 |
| 返回值处理 | 自动解析返回的 JSON、XML 或文本，供下游节点使用 |
配置流程
1.添加节点
在工作流画布中，从节点栏拖拽 HTTP 请求节点 至画布，并连接上游输出。
2.设置请求方法与地址
- 选择 HTTP 请求类型（如 GET 或 POST）；
- 在 URL 中可直接填写接口地址，或引用变量，如：
[https://api.example.com/user?id={{](https://api.example.com/user?id={{) user_id }}3.配置请求头（Headers）
可添加多个键值对，例如：
| Key | Value |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer {{ api_token }} |
若需调用需要认证的接口，可从上游节点动态获取授权信息。
4.配置请求体（Body）
- 支持
application/json、x-www-form-urlencoded、multipart/form-data、text/plain等多种格式； - 请求体中可以直接使用变量：
{
"name": "{{ user_name }}",
"message": "{{ user_message }}"
}5.测试请求
填写示例数据后，点击“测试”以验证请求是否成功，并检查返回结果格式。
6.配置输出变量
HTTP 请求节点默认输出：
| 变量名 | 类型 | 说明 |
|---|---|---|
status_code | Number | 响应状态码（如 200、404） |
headers | Object | 响应头信息 |
body | Object / String | 响应体，自动解析为 JSON 格式（若支持） |
场景
这个节点的一个实用特性是能够根据场景需要，在请求的不同部分动态插入变量。比如在处理客户评价请求时，你可以将用户名或客户ID、评价内容等变量嵌入到请求中，以定制化自动回复信息或获取特定客户信息并发送相关资源至特定的服务器。
HTTP 请求的返回值包括响应体、状态码、响应头和文件。值得注意的是，如果响应中包含了文件，这个节点能够自动保存文件，供流程后续步骤使用。这样不仅能提高处理效率，也可以更加简单直接地处理带有文件的响应。
发送文件
你可以使用 HTTP PUT 请求 将应用内的文件发送至其它 API 服务。在请求的 Body 中，可以在 binary 内选中文件变量。这种方式常用于文件传输、文档存储或媒体处理等场景。
示例：
假设你正在开发一个文档管理应用，需要将用户上传的 PDF 文件同步发送到第三方服务，可以通过 HTTP 请求节点通过文件变量进行传递。
配置示例：
高级配置
错误重试
当请求失败（如超时、500 错误）时，可以启用自动重试机制。 支持配置：
- 最大重试次数（默认 3 次）
- 重试间隔（默认 1000ms）
异常处理
【HTTP 节点】处理信息时有可能会遇到网络请求超时、请求限制等异常情况。应用开发者可以参考以下步骤配置异常分支，在节点出现异常时启用应对方案，而避免中断整个流程。
- 在 HTTP 节点启用 “异常处理”
- 选择异常处理方案并进行配置
并发调用
多个 HTTP 请求节点可在分支中并行执行， 适用于多源数据聚合、批量同步等高性能场景。
使用技巧
- 使用 变量表达式 动态生成请求路径、参数或 body；
- 可通过 模板转换节点 对响应结果进行格式化；
- 结合 条件分支节点 判断
status_code处理不同结果； - 对于私有接口，可通过系统变量引用密钥或环境变量；
- 可与 变量聚合节点 配合，将多个接口结果整合为统一输出。
小结
【HTTP 请求】节点让智能体具备访问外部系统与执行任务的能力，它是连接 AI 与真实业务世界的关键桥梁。 配合