n8n-workflow-patterns

n8n ワークフローパターン

n8n ワークフローを構築するための、実証済みのアーキテクチャパターンです。

使用する場面

• n8n ワークフローの構築前に、アーキテクチャパターンを選ぶ必要がある場合。
• タスクに、Webhook の処理、API 統合、スケジュール済みジョブ、データベース同期、AI エージェントのワークフロー設計が含まれる場合。
• ノード単位のトラブルシューティングではなく、ワークフローの大まかな構造を確認したい場合。

---

5 つのコアパターン

一般的な設計パターン：

1. Webhook の処理

   • HTTP リクエストを受信 → 処理 → 出力
   • パターン：Webhook → 検証 → 変換 → 応答／通知

2. [HTTP API 統合]

   • REST API から取得 → 変換 → 保存／利用
   • パターン：トリガー → HTTP Request → 変換 → アクション → エラーハンドラー

3. データベース操作

   • データベースデータの読み取り／書き込み／同期
   • パターン：スケジュール → クエリ → 変換 → 書き込み → 検証

4. AI エージェントのワークフロー

   • ツールとメモリを備えた AI エージェント
   • パターン：トリガー → AI Agent（モデル + ツール + メモリ）→ 出力

5. スケジュール済みタスク

   • 定期的に実行する自動化ワークフロー
   • パターン：スケジュール → 取得 → 処理 → 配信 → ログ記録

---

パターン選択ガイド

各パターンの使用場面：

Webhook の処理 - 次の場合に使用します：

• 外部システムからデータを受信する場合
• 統合機能（Slack コマンド、フォーム送信、GitHub Webhook など）を構築する場合
• イベントに即座に応答する必要がある場合
• 例：「Stripe の決済 Webhook を受信 → データベースを更新 → 確認を送信」

HTTP API 統合 - 次の場合に使用します：

• 外部 API からデータを取得する場合
• サードパーティサービスと同期する場合
• データパイプラインを構築する場合
• 例：「GitHub のイシューを取得 → 変換 → Jira チケットを作成」

データベース操作 - 次の場合に使用します：

• データベース間で同期する場合
• スケジュールに従ってデータベースクエリを実行する場合
• ETL ワークフローの場合
• 例：「Postgres のレコードを読み取り → 変換 → MySQL に書き込み」

AI エージェントのワークフロー - 次の場合に使用します：

• 会話型 AI を構築する場合
• AI にツールへのアクセスが必要な場合
• 複数ステップの推論タスクの場合
• 例：「ドキュメントの検索、データベースへのクエリ、メールの送信ができる AI とチャットする」

スケジュール済みタスク - 次の場合に使用します：

• 定期的なレポートや要約を作成する場合
• 定期的にデータを取得する場合
• メンテナンスタスクの場合
• 例：「毎日：分析データを取得 → レポートを生成 → チームにメールで送信」

---

一般的なワークフローコンポーネント

すべてのパターンで、次の構成要素を使用します。

1. トリガー

• Webhook - HTTP エンドポイント（即時）
• Schedule - Cron ベースのタイミング（定期的）
• Manual - クリックして実行（テスト用）
• Polling - 変更を確認（一定間隔）

2. データソース

• HTTP Request - REST API
• データベースノード - Postgres、MySQL、MongoDB
• サービスノード - Slack、Google Sheets など
• Code - カスタム JavaScript／Python

3. 変換

• Set - フィールドのマッピング／変換
• Code - 複雑なロジック
• IF/Switch - 条件付きルーティング
• Merge - データストリームを結合

4. 出力

• HTTP Request - API を呼び出す
• データベース - データを書き込む
• コミュニケーション - メール、Slack、Discord
• ストレージ - ファイル、クラウドストレージ

5. エラー処理

• Error Trigger - ワークフローエラーを捕捉
• IF - エラー条件を確認
• Stop and Error - 明示的に失敗させる
• Continue On Fail - ノード単位の設定

有効化する前に、認証情報の適用範囲、送信先の受信者、有料の処理や API の影響を確認してください。Webhook を認証し、ペイロードを検証し、配信 ID の重複を排除して、冪等性のある書き込みを使用してください。再試行には上限とバックオフを設けてください。タイムアウトの前に副作用を伴う処理が成功していることもあります。AI ツールの利用を制限し、取得したコンテンツは信頼できないものとして扱ってください。Error Trigger は、通常のメインワークフローの分岐ではなく、別途構成したエラーワークフローに属します。分岐が順番に並んでいても、並行して実行されるとは限りません。

ワークフロー作成チェックリスト

あらゆるワークフローの構築時に、次のチェックリストに従ってください。

計画フェーズ

• パターンを特定する（Webhook、API、データベース、AI、スケジュール）
• 必要なノードを列挙する（search_nodes を使用）
• データフローを把握する（入力 → 変換 → 出力）
• エラー処理の方針を計画する

実装フェーズ

• 適切なトリガーでワークフローを作成する
• データソースノードを追加する
• 認証情報を設定する
• 変換ノード（Set、Code、IF）を追加する
• 出力／アクションノードを追加する
• エラー処理を設定する

検証フェーズ

• 各ノードの設定を検証する（validate_node）
• ワークフロー全体を検証する（validate_workflow）
• サンプルデータでテストする
• エッジケース（空のデータ、エラー）に対応する

デプロイフェーズ

• ワークフローの設定（実行順序、タイムアウト、エラー処理）を確認する
• activateWorkflow 操作を使用してワークフローを有効化する
• 初回の実行を監視する
• ワークフローの目的とデータフローを文書化する

---

データフローパターン

リニアフロー

Trigger → Transform → Action → End

使用する場面: 単一の経路を持つシンプルなワークフロー

分岐フロー

Trigger → IF → [True Path]
             └→ [False Path]

使用する場面: 条件に応じて異なるアクションを実行する場合

並列処理

Trigger → [Branch 1] → Merge
       └→ [Branch 2] ↗

使用する場面: 同時に実行できる独立した処理

ループパターン

Trigger → Split in Batches → Process → Loop (until done)

使用する場面: 大規模なデータセットを分割して処理する場合

エラーハンドラーパターン

Main Flow → [Success Path]
         └→ [Error Trigger → Error Handler]

使用する場面: エラー処理用に個別のワークフローが必要な場合

---

よくある落とし穴

1. Webhookのデータ構造

問題: Webhookのペイロードデータにアクセスできません

解決策: データは $json.body の下にネストされています

❌ {{$json.email}}
✅ {{$json.body.email}}

参照先: n8n Expression Syntaxスキル

2. 複数の入力アイテム

問題: ノードがすべての入力アイテムを処理しますが、1つだけを処理したい場合

解決策: 「Execute Once」モードを使用するか、最初のアイテムだけを処理します

{{$input.first().json.field}}  // First item only

3. 認証の問題

問題: API呼び出しが401／403エラーで失敗します

解決策:

• 認証情報を適切に設定する
• パラメーターではなく、「Credentials」セクションを使用する
• ワークフローを有効化する前に認証情報をテストする

4. ノードの実行順序

問題: ノードが予期しない順序で実行されます

解決策: ワークフローの設定 → 実行順序を確認します

• v0: 上から下（旧方式）
• v1: 接続ベース（推奨）

5. 式のエラー

問題: 式が文字列として表示されます

解決策: 式を {{}} で囲みます

• 詳細はn8n Expression Syntaxスキルを参照してください

---

他のスキルとの連携

次のスキルはWorkflow Patternsと連携して使用できます。

n8n MCP Tools Expert - 次の用途に使用します:

• パターンに適したノードを見つける（search_nodes）
• ノードの操作を理解する（get_node）
• ワークフローを作成する（n8n_create_workflow）
• テンプレートをデプロイする（n8n_deploy_template）
• AIパターンのガイダンスにはai_agents_guideを使用する

n8n Expression Syntax - 次の用途に使用します:

• 変換ノードで式を書く
• Webhookデータに正しくアクセスする（{{$json.body.field}}）
• 前のノードを参照する（{{$node["Node Name"].json.field}}）

n8n Node Configuration - 次の用途に使用します:

• パターン内のノードに特定の操作を設定する
• ノード固有の要件を理解する

n8n Validation Expert - 次の用途に使用します:

• ワークフローの構造を検証する
• 検証エラーを修正する
• デプロイ前にワークフローの正確性を確認する

---

根拠とバージョンの範囲

これらのパターンは設計上のヒューリスティックであり、使用状況を測定した統計ではありません。普及率、割合、平均編集時間を裏付けるデータセットや方法論は含まれていません。ノード名と利用可能な操作は、インストールされているn8nおよびMCPのバージョンによって異なります。後述する詳細なパターンファイルはここには含まれていません。参照したと主張するのではなく、インストール済みのドキュメントまたはn8n公式ドキュメントを使用してください。

---

クイックスタートの例

例1: シンプルなWebhook → Slack

1. Webhook (path: "form-submit", POST)
2. Set (map form fields)
3. Slack (post message to #notifications)

例2: スケジュールされたレポート

1. Schedule (daily at 9 AM)
2. HTTP Request (fetch analytics)
3. Code (aggregate data)
4. Email (send formatted report)
5. Error Trigger → Slack (notify on failure)

例3: データベースの同期

1. Schedule (every 15 minutes)
2. Postgres (query new records)
3. IF (check if records exist)
4. MySQL (insert records)
5. Postgres (update sync timestamp)

例4: AIアシスタント

1. Webhook (receive chat message)
2. AI Agent
   ├─ OpenAI Chat Model (ai_languageModel)
   ├─ HTTP Request Tool (ai_tool)
   ├─ Database Tool (ai_tool)
   └─ Window Buffer Memory (ai_memory)
3. Webhook Response (send AI reply)

例5: API連携

1. Manual Trigger (for testing)
2. HTTP Request (GET /api/users)
3. Split In Batches (process 100 at a time)
4. Set (transform user data)
5. Postgres (upsert users)
6. Loop (back to step 3 until done)

---

詳細なパターンファイル

各パターンの詳しいガイダンスについては、以下をご覧ください。

• webhook_processing.md - Webhook パターン、データ構造、レスポンスの処理
• http_api_integration - REST API、認証、ページネーション、リトライ
• database_operations.md - クエリ、同期、トランザクション、バッチ処理
• ai_agent_workflow.md - AI エージェント、ツール、メモリー、langchain ノード
• scheduled_tasks.md - Cron スケジュール、レポート、保守タスク

---

実際のテンプレート例

n8n テンプレートライブラリより：

テンプレート #2947：天気情報を Slack に送信

• パターン：スケジュールタスク
• ノード：Schedule → HTTP Request（weather API）→ Set → Slack
• 複雑さ：シンプル（4 ノード）

Webhook 処理：最も一般的なパターン

• 最も一般的な用途：フォーム送信、決済 Webhook、チャット連携

HTTP API：一般的なパターン

• 最も一般的な用途：データ取得、サードパーティとの連携

データベース操作：一般的なパターン

• 最も一般的な用途：ETL、データ同期、バックアップのワークフロー

AI エージェント：利用が増加中

• 最も一般的な用途：チャットボット、コンテンツ生成、データ分析

例を探すには、n8n-mcp ツールの search_templates と get_template を使用してください！

---

ベストプラクティス

✅ 推奨事項

• 問題を解決できる最もシンプルなパターンから始めます
• 構築前にワークフローの構成を計画します
• すべてのワークフローでエラー処理を使用します
• 有効化する前にサンプルデータでテストします
• ワークフロー作成チェックリストに従います
• ノードには内容が分かる名前を付けます
• 複雑なワークフローにはドキュメントを作成します（notes フィールド）
• デプロイ後にワークフローの実行を監視します

❌ 避けるべき事項

• ワークフローを一度に作成する（変更のたびに反復して確認します）
• 有効化前の検証を省略する
• エラーが発生する状況を無視する
• シンプルなパターンで十分な場合に複雑なパターンを使う
• パラメーターに認証情報をハードコードする
• データが空の場合の処理を忘れる
• 明確な境界を設けずに複数のパターンを混在させる
• テストせずにデプロイする

---

まとめ

重要なポイント：

1. 5 つの中核パターンが基本構成を提供します
2. Webhook 処理は受信イベントに適しています
3. すべてのワークフローでワークフロー作成チェックリストを使用します
4. パターンを計画 → ノードを選択 → 構築 → 検証 → デプロイ
5. 他のスキルと連携し、ワークフロー開発を完成させます

次のステップ：

1. ユースケースに合うパターンを特定します
2. 詳細なパターンファイルを読みます
3. n8n MCP Tools Expert を使用してノードを探します
4. ワークフロー作成チェックリストに従います
5. n8n Validation Expert を使用して検証します

関連スキル：

• n8n MCP Tools Expert - ノードの検索と設定
• n8n Expression Syntax - 式を正しく記述
• n8n Validation Expert - エラーの検証と修正
• n8n Node Configuration - 特定の操作を設定

制限事項

• このスキルは、タスクが上記の説明範囲に明確に当てはまる場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を止めて確認を求めてください。