跳到主要内容

HTTP request 组件 (HTTP Request Component)

该组件用于调用远程服务。

HTTP request (HTTP 请求) 组件允许您通过提供 URL 和 HTTP 方法来访问远程 API 或服务，并接收其响应。您可以自定义请求头 (Headers)、参数 (Parameters)、代理 (Proxy) 和超时时间 (Timeout)，并使用常见的 GET、POST 等方法。这在工作流中与外部系统进行数据交换非常有用。

前提条件 (Prerequisites)

  • 可访问的远程 API 或服务。
  • 如果目标服务需要身份验证，请在请求头中添加 Token 或凭据。

配置项 (Configurations)

Url

必填。完整的请求地址，例如：http://api.example.com/data。

Method (方法)

选择的 HTTP 请求方法。可用选项：

  • GET
  • POST
  • PUT

Timeout (超时时间)

请求的最大等待时间，以秒为单位。默认值为 60。

Headers (请求头)

可在此处设置自定义 HTTP 请求头，例如：

{
  "Accept": "application/json",
  "Cache-Control": "no-cache",
  "Connection": "keep-alive"
}

Proxy (代理)

可选。用于此请求的代理服务器地址。

Clean HTML (清除 HTML 标签)

布尔值 (Boolean)：是否从返回结果中删除 HTML 标签，仅保留纯文本。

Parameter (参数)

可选。随 HTTP 请求发送的参数。支持键值对 (Key-Value Pairs)：

  • 要使用动态系统变量分配值，请将其设置为 Variable (变量)。
  • 要在某些条件下覆盖这些动态值并改用固定的静态值，选择 Value (值) 是合适的。
注意
  • 对于 GET 请求，这些参数将附加到 URL 的末尾。
  • 对于 POST/PUT 请求，它们将作为请求体 (Request Body) 发送。

示例配置

示例响应

{ "args": { "App": "RAGFlow", "Query": "How to do?", "Userid": "241ed25a8e1011f0b979424ebc5b108b" }, "headers": { "Accept": "/", "Accept-Encoding": "gzip, deflate, br, zstd", "Cache-Control": "no-cache", "Host": "httpbin.org", "User-Agent": "python-requests/2.32.2", "X-Amzn-Trace-Id": "Root=1-68c9210c-5aab9088580c130a2f065523" }, "origin": "185.36.193.38", "url": "https://httpbin.org/get?Userid=241ed25a8e1011f0b979424ebc5b108b&App=RAGFlow&Query=How+to+do%3F" }

Output (输出)

HTTP 请求组件输出的全局变量名称，可以被工作流中的其他组件引用。

  • Result：string（字符串），远程服务返回的响应内容。

示例 (Example)

这是一个使用示例：工作流在 Begin 组件中发起，通过 HTTP Request_0 组件向 https://httpbin.org/get 发送 GET 请求并向服务器传递参数，最后通过 Message_0 组件输出结果。