HTTP 请求

HTTP 请求节点是 XpertAI 平台智能体工作流中重要节点，可在智能体流程中灵活调用外部 API，实现数据交互、自动化触发以及复杂的系统集成。

📌 功能概览

HTTP 请求节点支持在工作流中发起标准的 Web 请求（如 GET、POST 等），可与任意支持 HTTP 协议的服务进行对接。无论是拉取数据、提交表单，还是触发第三方系统指令，该节点都能轻松实现。

🔧 配置项说明

当你拖入一个 HTTP 请求节点后，可以在右侧面板中进行如下配置：

1. 请求方法与地址（API）

• 方法类型：支持 GET、POST、PUT、DELETE 等常用 HTTP 方法。
• 请求地址：填写完整的 API 地址，例如 https://api.example.com/data。

2. Headers（请求头）

可添加多个 Header 键值对，用于传递如认证令牌（Token）、内容类型（Content-Type）等信息。

• Name：Header 名称，例如 Authorization
• Value：Header 值，例如 Bearer {{access_token}}

3. Params（请求参数）

支持设置 URL 参数，适用于 GET 请求或拼接查询参数使用。

• Key：参数名
• Value：参数值（支持动态变量）

4. Body（请求体）

用于 POST、PUT 等带请求体的请求。

• 支持格式：
  • x-www-form-urlencoded
  • JSON
  • RAW
• 可填写具体字段，或绑定变量传递动态数据。

5. Timeout 设置（超时控制）

可针对网络状况或接口响应慢的场景进行细致配置：

• Connection Timeout：连接超时时间（秒）
• Read Timeout：读取数据超时时间（秒）
• Write Timeout：发送数据超时时间（秒）

6. 输出变量

HTTP 请求节点输出的会话变量默认有三个：

• body 返回体。
• status_code 返回状态码。
• headers 返回头。

7. 异常处理

参考 错误处理

✅ 使用示例

例如你希望在某个节点自动调用天气查询 API，可以配置如下：

• 方法：GET
• 地址：https://api.weatherapi.com/v1/current.json
• Params：
  • key: {{weather_api_key}}
  • q: {{user_location}}
• 无需请求体
• 超时时间默认或自定义填写

🚀 使用场景

• 调用企业内部系统或第三方接口
• 实现信息同步、通知推送
• 联动 CRM、ERP、微信企业号、Slack 等工具
• 拓展智能体能力边界，实现更强大的自动化处理逻辑