> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 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. 异常处理

参考 [错误处理](/docs/ai/workflow/error-handling/)

## ✅ 使用示例

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

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

## 🚀 使用场景

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