Contents
1. n8n と AI 統合機能の概要
n8n はノーコードで 400 種類以上のサービスを連結できるワークフロー自動化プラットフォームです。2024 年リリースの AI ノード では、OpenAI の GPT‑4o、Anthropic の Claude 3、そしてカスタム LLM 用の汎用 API 呼び出しが標準装備されています。本セクションでは、各モデルの主な特長と導入シーンを把握し、業務要件に最適な選択肢を判断できるようにします。
1‑1. 対応 AI モデル一覧
以下は n8n が公式ドキュメントで提供している AI ノードの対応モデルです。表は各モデルの特徴と推奨ユースケースをまとめたものです(出典は n8n 公式サイト [1])。
| モデル | 主な特徴 | 推奨ユースケース |
|---|---|---|
| OpenAI GPT‑4o | マルチモーダル(テキスト・画像・音声)対応、リアルタイム応答が高速、トークン単価は GPT‑4 と同等 [2] | カスタマーサポートチャットボット、文書要約・翻訳 |
| Anthropic Claude 3 | 最大 100k トークンの長文コンテキストに強く、指示遵守が高精度 [3] | 法務文書解析、レポート自動生成 |
| カスタム LLM API | 完全プライベート運用可能、エンドポイントと認証情報だけで呼び出し [4] | 機密情報を扱う社内ナレッジ検索、業界特化モデルの活用 |
注記:上記モデルは 2024 年 5 月時点で n8n が公式にサポートしているものです。将来的な追加・削除はベンダー発表次第で変わります。
2. 環境構築 ― セルフホスト vs n8n.cloud
ワークフローを本番運用する際の選択肢は大きく分けて セルフホスト(Docker/Kubernetes)と マネージド版 n8n.cloud の 2 パターンです。ここではそれぞれの導入手順・メリット・デメリットを整理し、10 分以内に動作確認できる流れを示します。
2‑1. セルフホストのインストール手順
前提条件
- Docker Engine ≥ 20.10
- Docker Compose ≥ 2.0(
docker composeコマンド) kubectlと Helm がインストール済み(Kubernetes デプロイを行う場合)
2‑1‑a. Docker Compose によるローカル起動
Docker Compose 用設定ファイルは以下の通りです。docker-compose.yml として保存し、docker compose up -d コマンドで起動します(docker‑compose ではなく docker compose が推奨)[5]。
|
1 2 3 4 5 6 7 8 9 10 11 12 |
version: "3.9" services: n8n: image: n8nio/n8n:latest ports: - "5678:5678" environment: DB_TYPE: sqlite N8N_HOST: localhost GENERIC_TIMEZONE: Asia/Tokyo NODE_FUNCTION_ALLOW_EXTERNAL: axios,sharp |
ポイント:
environmentに機密情報(API キー等)を直接書かず、.envファイルで管理しdocker compose --env-file .env up -dと実行すると安全です。
2‑1‑b. Kubernetes (Helm) による本番レベルのデプロイ
公式 Helm チャートは GitHub リポジトリ [6] に掲載されています。最小構成の例を示します。
|
1 2 3 4 5 6 7 8 9 |
helm repo add n8n https://helm.n8n.io helm install n8n-prod n8n/n8n \ --set service.type=LoadBalancer \ --set env.DB_TYPE=postgresql \ --set env.POSTGRES_DB=n8n \ --set env.POSTGRES_USER=n8n_user \ --set env.POSTGRES_PASSWORD=$(openssl rand -base64 12) \ --set resources.limits.cpu=500m |
Helm の --set オプションで環境変数やリソース上限を一括指定できます。シークレットは Kubernetes の Secret リソースに格納してください(下記「セキュリティ」参照)。
2‑1‑c. n8n.cloud の無料トライアル開始手順
- n8n.cloud 公式ログインページ [7] にアクセスし Start free trial をクリック。
- 組織名と希望インスタンス名を入力してメール認証を完了。
- ダッシュボード左側の Integrations → API Keys で OpenAI/Anthropic の API キーを登録すれば、即座に AI ノードが利用可能です。
比較まとめ(コスト・運用負荷は次節で詳細化)
3. 基本的なワークフロー設計と AI ノード設定
AI を組み込んだ自動化は「トリガー → 処理 → 出力」のシンプルな流れが基本です。ここではエラーハンドリングや条件分岐を含む典型パターンと、プロンプト設計・シークレット管理のベストプラクティスを解説します。
3‑1. トリガー・条件分岐・AI 処理の構成例
| ステップ | ノード例 | 主な設定ポイント |
|---|---|---|
| 1️⃣ トリガー | Webhook(外部サービスから POST) |
URL は公開エンドポイントにし、認証ヘッダーを必須化 |
| 2️⃣ 条件分岐 | IF(件名が「重要」か判定) |
式は {{ $json.subject.includes('重要') }} |
| 3️⃣ AI 処理 | OpenAI GPT‑4o(要約生成) |
プロンプトは Function ノードで動的組立 |
| 4️⃣ エラーハンドリング | Error Trigger + Slack(例外通知) |
エラー情報を JSON 化し、チャンネルへ送信 |
Function ノードでのプロンプト生成例
|
1 2 3 4 5 6 7 |
const prompt = ` 以下のメール本文を要約してください。文字数は 150 文字以内に抑えてください。 --- ${$json.body} ---`; return [{ json: { prompt } }]; |
3‑2. API キー・シークレット管理のベストプラクティス
| 項目 | 推奨設定 |
|---|---|
| API キー保存先 | n8n の Credentials > API Key に暗号化保存し、ノードは {{ $credentials.myApiKey }} で参照 |
| 環境変数の扱い | Docker/Kubernetes では .env や Secret リソースに格納し、コードや設定ファイルに平文を書かない |
| プロンプトテンプレート | プレースホルダー {input} を使用し Function ノードで文字列結合。変更は一箇所だけで済むように管理 |
4. 実践テンプレートハンズオン
本稿で提供する ZIP ファイル(ダウンロードリンクは n8n の公式リポジトリ [8])には、以下の 3 種類 のサンプルワークフローが収録されています。インポート後すぐに動作確認が可能です。
4‑1. メール自動要約+Slack 通知
| 手順 | 内容 |
|---|---|
| ① トリガー | IMAP Email ノードで「重要」メールを取得 |
| ② 条件分岐 | IF で件名に「重要」か判定 |
| ③ AI 処理 | OpenAI GPT‑4o に要約プロンプトを送信 |
| ④ 出力 | Slack ノードへ要約テキストを送信 |
4‑2. 画像生成+Twitter 投稿
| 手順 | 内容 |
|---|---|
| ① スケジュール | Cron(毎日 09:00) |
| ② AI 処理 | OpenAI GPT‑4o (image) に「春の桜とロボット」等のプロンプト |
| ③ メディアアップロード | Twitter ノードで画像バイナリを投稿 |
4‑3. 顧客問い合わせチャットボット
| 手順 | 内容 |
|---|---|
| ① 受信 | Webhook(Web フォーム) |
| ② AI 応答 | Claude 3 に「150文字以内で回答」プロンプトを送付 |
| ③ エスカレーション判定 | IF で Claude の confidence < 0.7 をチェックし、低信頼度は Email(担当者)へ転送 |
活用ポイント:すべてのテンプレートは「トリガー → AI ノード → 出力」のシンプル構造に統一しているため、カスタマイズが容易です。
5. セキュリティ・コスト・運用ベストプラクティス
AI ワークフローを本番環境で安全かつ費用効果的に運用するための具体策をまとめます。
5‑1. シークレット管理とアクセス制御
- Docker / Compose:
.envファイルはホスト側だけに置き、docker compose --env-file .env up -dで読み込む。 - Kubernetes:機密情報は
Secretリソースに Base64 エンコードして保存し、Pod の環境変数としてマウントする(例は前節参照)。 - OAuth 認証:外部サービス(Slack、Google 等)と連携するときは n8n の Credentials で OAuth クライアントを登録し、リダイレクト URI をインスタンスの公開 URL に設定。
- IP 制限:セルフホストの場合は Ingress コントローラやクラウドファイアウォールで管理者 IP のみ許可。n8n.cloud では「Allowed IPs」機能が利用可能です [9]。
5‑2. コスト比較(2024 年料金)
| 項目 | セルフホスト(月額概算) | n8n.cloud(有料プラン) |
|---|---|---|
| インフラ費 | VPS (2 CPU, 4 GB RAM) 約 $15 [10] | プランに応じ $20〜$120 |
| AI 使用料 | OpenAI GPT‑4o $0.02/1k トークン、Claude 3 $0.015/1k トークン(公式料金表 [2][3]) | 同一料金体系で課金 |
| 管理工数 | OS 更新・バックアップ等 ≈ $100/月相当の人件費 | n8n が自動管理、追加コストなし |
| スケーラビリティ | 手動でノード増減。Kubernetes 利用時は HPA により自動スケール可 | プラン変更だけで即座にリソース上限拡張 |
注:上記は 2024 年 5 月時点の公表価格を元に概算したものです。実際の利用量やリージョンによって変動します。
5‑3. デバッグ・トラブルシューティングのチェックリスト
| エラー | 主な原因 | 解決策 |
|---|---|---|
| 401 Unauthorized (AI ノード) | API キー未設定、または期限切れ | n8n の Credentials を再確認し、環境変数も更新 |
| Webhook not received | コンテナのポート公開漏れ/Ingress 設定ミス | docker ps でポートマッピングを確認、Ingress ルールを検証 |
| Execution timed out | 大量データ処理が単一ノードに集中 | SplitInBatches ノードで分割し、Run Once のタイムアウト設定を伸長 |
| JSON Parse error | AI 応答形式変更(例:choices 配列の構造) | Function ノードで try/catch を入れ、実際のパス ($json["choices"][0]["message"]["content"]) を確認 |
6. まとめ
- AI ノードは 2024 年時点で GPT‑4o・Claude 3·カスタム LLM の 3 種類が公式に利用可能。それぞれの特性を踏まえてユースケースを選定してください。
- セルフホストは柔軟性とコントロール性、n8n.cloud は導入ハードルの低さ が特徴です。コスト・運用リソースを総合的に比較し、段階的な移行も検討しましょう。
- シークレット管理・IP 制限は必須。Docker/Kubernetes のベストプラクティスに従い、機密情報は決して平文で保存しないようにしてください。
- コストはインフラ費と AI 使用料が主軸。公式料金表と自社のトラフィック見積もりを元にシミュレーションし、月次レポートで継続的にモニタリングすることが重要です。
以上を踏まえて、まずは テンプレートハンズオン を実行し、n8n と AI の連携感覚を体感してみてください。質問や不明点があれば n8n フォーラムや公式ドキュメントをご活用いただくとスムーズです。
参考文献
- n8n Documentation – AI Nodes (2024) https://docs.n8n.io/integrations/ai-nodes
- OpenAI Pricing (2024) https://openai.com/pricing
- Anthropic Claude 3 Technical Overview (2024) https://www.anthropic.com/product
- n8n – Custom LLM Integration (2024) https://github.com/n8n-io/n8n/tree/master/packages/integrations/llm-custom
- Docker Compose Documentation – Command reference (2024) https://docs.docker.com/compose/reference/overview/
- n8n Helm Chart Repository (2024) https://helm.n8n.io
- n8n.cloud – Start Free Trial (2024) https://app.n8n.cloud/login
- n8n Sample Workflows GitHub (2024) https://github.com/n8n-io/sample-workflows
- n8n.cloud Security Settings (2024) https://docs.n8n.io/hosting/cloud/security/
- VPS Pricing Survey – 2024 Q1 (参考) https://www.digitalocean.com/pricing