業務自動化

n8nの拡張HTTPリクエスト機能でAPI連携を次のレベルへ:新機能完全ガイド

ENHANCED編集部更新 約11分で読めます

n8n の「拡張 HTTP リクエスト機能」とは、n8n 1.90.0(2025年4月22日公開)で、AI Agent が使う「HTTP Request ツール」を、通常の HTTP Request ノードと同じ設定ができるようにした変更です。 ページネーション・バッチ処理・タイムアウト・リダイレクト・プロキシ・cURL の取り込みがツールでも使えるようになり、$fromAI() で AI に値を埋めさせられるようになりました。通常の HTTP Request ノードそのものに、新しい設定項目が大量に増えたわけではありません。

この記事は 2026年10月に、n8n の公式ドキュメントと GitHub のリリースノートをもとに全面的に書き直しました。以前の版にあった、n8n に存在しない設定項目(条件付きリトライ・キャッシュ・ストリーミング・レート制限・ファイル保存・OAuth の自動更新など)の設定例は削除しています。

n8n 1.90.0 で何が変わったのか

n8n には、ワークフローの中で API を呼ぶための HTTP Request ノードがあります。これとは別に、AI Agent ノードにつないで、AI が自分の判断で Web サイトや API を呼べるようにする HTTP Request ツールがあります。ツールのほうは n8n 1.49.0(2024年7月)で加わりました。

1.90.0 では、このツールが「通常の HTTP Request ノードのツール版」に置き換えられました。公式のリリースノートが挙げている変化は次の 2 つです。

  • 通常のノードの詳しい設定が、ツールでも使える:ページネーション(Pagination)、バッチ処理(Batching)、タイムアウト(Timeout)、リダイレクト(Redirects)、プロキシ(Proxy)、cURL の取り込み
  • $fromAI() に対応:パラメーターの値を、AI がプロンプトの文脈から決めて埋められる

つまり、以前の版の記事にあったような「HTTP Request ノードに新機能が入った」という話ではなく、AI Agent から API を呼ぶときにも、ふだんの HTTP Request ノードと同じことができるようになったという変更です。

HTTP Request ツールを AI Agent に足す手順

1.90.0 のリリースノートに書かれている手順です。

  1. キャンバスで AI Agent ノードを開く
  2. 「+」のアイコンを押して、ツールの接続を足す
  3. ツールの一覧から「HTTP Request Tool」を選ぶ
  4. 通常の HTTP Request ノードと同じように設定する(詳しいオプションも含む)

HTTP Request で設定できること

ツールとして使う場合も、通常のノードとして使う場合も、設定できるのは次の項目です(公式ドキュメントの HTTP Request のページより)。

基本の設定

項目 内容
Method DELETE・GET・HEAD・OPTIONS・PATCH・POST・PUT から選ぶ
URL 呼び出すエンドポイント
Authentication n8n が対応しているサービスなら「Predefined Credential Type」、それ以外は「Generic Credential Type」(Basic auth・Custom auth・Digest auth・Header auth・OAuth1 API・OAuth2 API・Query auth など)の資格情報を選ぶ
Send Query Parameters クエリパラメーターを、欄に入力するか JSON で指定する
Send Headers ヘッダーを、欄に入力するか JSON で指定する
Send Body Form URLencoded・Form-Data・JSON・n8n Binary File・Raw から形式を選んで本文を送る

API の説明書に cURL のコマンドが載っていれば、「Import cURL」に貼り付けて、これらの欄をまとめて埋めることもできます。

オプション(Add Option から足す)

オプション 内容
Array Format in Query Parameters クエリパラメーターの配列の書き方(括弧なし・括弧のみ・番号つきの括弧)
Batching 1 回にまとめる件数(Items per Batch)と、まとまりの間の待ち時間(Batch Interval、ミリ秒)
Ignore SSL Issues SSL 証明書の検証に失敗しても応答を受け取る
Lowercase Headers ヘッダー名を小文字にするか(初期値はオン)
Redirects リダイレクトをたどるか、たどる回数の上限
Response 応答のヘッダーとステータスも返すか、2xx 以外でもエラーにしないか(Never Error)、応答の形式(Autodetect・File・JSON・Text)
Pagination 複数のページに分かれた結果をまとめて取る
Proxy 使う HTTP プロキシ
Timeout 応答のヘッダーが返るまで待つ時間(ミリ秒)。1 つの値だけを指定する

ツールのときだけ使える設定:Optimize Response

AI Agent につないだときだけ、Optimize Response という設定が使えます。AI に渡す応答のデータを減らして、費用を抑えたり、AI が大事でない部分に気を取られないようにしたりするためのものです。

  • JSON:データが入っている項目を指定したり、含める・除く項目を選んだりする
  • HTML:CSS セレクターで必要な部分だけを取り出す、タグを外して中身だけにする、文字数で切る
  • Text:文字数で切る

$fromAI() で AI に値を埋めさせる

$fromAI() は、AI Agent につないだツールのパラメーターを、AI に埋めさせるための関数です。引数は値そのものではなく、「何を入れてほしいか」を AI に伝える手がかりです。

引数 必須 内容
key 必須 引数の名前。1〜64 文字で、英字・数字・_・- だけ
description 任意 引数の説明
type 任意 string・number・boolean・json のどれか(初期値は string)
defaultValue 任意 値が決まらないときに使う値

公式ドキュメントの例です。

{{ $fromAI('email') }}
$fromAI("numItemsInStock", "Number of items in stock", "number", 5)

欄の一部だけを AI に埋めさせることもできます。たとえば次のように書くと、AI が作った件名の前に、決まった文字列が付きます。

Generated by AI: {{ $fromAI("subject") }}

HTTP Request ツールなら、たとえばクエリパラメーターの値に $fromAI() を書いておくと、ユーザーの質問に合わせて AI が検索の言葉や ID を入れて API を呼べます。

式を書かずに AI に任せる方法

パラメーターの欄の右端にある星のボタンを押すと、その欄を AI が埋めるように、式が自動で設定されます。手で書いた値は上書きされるので注意してください。「X」を押すと手で書く設定に戻り、自動で作られた式を直して使うこともできます。

注意

  • $fromAI() が使えるのは、AI Agent ノードにつないだツールだけです。通常の HTTP Request ノードでは使えません
  • Code ツールや、ツール以外のサブノードでも使えません

よくある勘違い:存在しない設定と、代わりに使うもの

以前の版の記事に載せていた次の設定は、n8n の HTTP Request にはありません。やりたいことに近い、実在する機能を挙げます。

以前の版にあった設定 実際には 代わりに使うもの
ステータスコードごとのリトライ条件、指数バックオフ 無い ノードの Settings タブの Retry On Fail(最大の回数 Max Tries と、待ち時間 Wait Between Tries (ms))
エラーのときの独自の処理 専用の設定は無い Settings タブの On Error(Stop Workflow・Continue・Continue (using error output))。2xx 以外もエラーにしたくなければ Response の Never Error
リクエストとレスポンスで別々のタイムアウト 無い Timeout(1 つの値、ミリ秒)
並列数・レート制限・429 のときの自動の減速 無い Batching(件数と間隔)と Retry On Fail
JSONPath での応答の変換 無い 後ろのノード(Code ノードなど)で加工する。ツールなら Optimize Response で AI に渡す項目を絞れる
応答のキャッシュ、ストリーミングでの分割処理 無い —
ファイルのパスへの保存 無い Response の形式を File にするとバイナリのデータとして出力されるので、保存は別のノードで行う
OAuth のトークンの自動更新の設定、スコープを式で変える設定 このような設定項目は無い Authentication で OAuth2 API などの資格情報を選ぶ
式の中の $credentials・$statusCode・$error 公式の説明に無い 資格情報は Authentication で選ぶ。$response はページネーションの式の中で使う

429 エラー(リクエストが多すぎる)への対処

公式ドキュメントが挙げている方法は、次の 2 つです。

  • Batching:「Add Option」→「Batching」で、Items per Batch に件数を、Batch Interval (ms) に間隔を入れる。たとえば 1 秒に 1 回にしたいなら、Batch Interval (ms) を 1000 にする
  • Retry On Fail:Settings タブで Retry On Fail をオンにし、Max Tries に最大の回数、Wait Between Tries (ms) に待ち時間を入れる

ページネーションの設定例

ページネーションは、式と組み込みの変数で組み立てます。公式のクックブックの例です。

  • 応答に次のページの URL が入っている:Pagination Mode を「Response Contains Next URL」にし、Next URL に {{ $response.body["next-page"] }} のような式を書く(項目名は API によって違います)
  • ページの番号で取る:Pagination Mode を「Update a Parameter in Each Request」にし、Type を Query、Name を page などにして、Value に {{ $pageCount + 1 }} と書く($pageCount は取得したページの数で、0 から数えるため)

よくある質問

通常の HTTP Request ノードにも新機能が入ったのですか?

いいえ。1.90.0 で変わったのは、AI Agent が使う HTTP Request ツールです。通常のノードにすでにあった設定を、ツールでも使えるようにしました。

$fromAI() は通常のワークフローでも使えますか?

使えません。AI Agent ノードにつないだツールの中だけで使えます。

失敗したリクエストを自動でやり直せますか?

ノードの Settings タブで Retry On Fail をオンにすると、最大の回数と待ち時間を決めてやり直せます。ステータスコードごとに条件を分ける設定はありません。

今の n8n でも同じ機能ですか?

はい。今の公式ドキュメントでも、HTTP Request は通常のノードとしても、AI Agent のツールとしても使えると説明されています。なお n8n は今は 2.x 系です(2026年10月5日に n8n@2.42.3 が公開)。

まとめ

  • 拡張 HTTP リクエスト機能は、n8n 1.90.0 で AI Agent 用の HTTP Request ツールを、通常の HTTP Request ノードと同じ設定に対応させた変更
  • ツールでも、ページネーション・バッチ処理・タイムアウト・リダイレクト・プロキシ・cURL の取り込みが使える
  • $fromAI() や星のボタンで、パラメーターの値を AI に埋めさせられる。使えるのは AI Agent につないだツールだけ
  • リトライは Retry On Fail、429 への対処は Batching と Retry On Fail。キャッシュやストリーミングなどの設定は無い

n8n を使った業務自動化の例は、n8nで毎日の手作業を自動化。中小企業の実例9選と始め方でも紹介しています。

エンハンスドでは、AI と自動化ツールを組み合わせて業務の流れを作り直す支援を行っています(AI × ハイパーオートメーション)。

あわせて読みたい

参考資料

次に読む

この記事に関わるエンハンスドの事業

AI活用・無料相談

部門やシステムをまたぐ業務を、まとめて自動化します

生成 AI・RPA・API・SaaS・既存のシステムをつなぎ、部門やシステムをまたぐ一連の業務を自動化します。どこから自動化するかの整理からご一緒します。

  • 自動化する範囲の整理
  • 生成 AI・RPA・API・SaaS をつなぐ仕組みの構築
  • 部門・システムをまたぐ業務の自動化
自動化を相談する

ご相談は何度でも無料です。まずはお気軽にお問い合わせください。

← 記事一覧に戻る