Contents
スポンサードリンク
1. n8n とは？ – 基本概念と導入フロー
| 項目 | クラウド版 | 自己ホスト版 |
|---|---|---|
| 特徴 | SaaS 型でインフラ管理不要。無料プランあり（実行数・同時実行に上限）。 | 完全オープンソース。Docker、Kubernetes など好きな環境へデプロイ可能。 |
| 料金 | 無料プラン＋従量課金プラン。 | ソフトウェアは無料。サーバー費用・運用コストが発生。 |
| メンテナンス | n8n が自動でアップデート・バックアップを実行。 | アップデート・バックアップは自社で管理（公式 Helm chart などが便利）。 |
1‑1. クラウド版アカウント作成手順
- https://app.n8n.io にアクセスし Sign up をクリック。
- メール認証 → ワークスペース名・パスワードを入力。
- ダッシュボードが表示されたら左メニューの Workflow → New Workflow で新規作成。
1‑2. 自己ホスト版インストール概要
- Docker（推奨）
bash
docker run -p 5678:5678 \
-e N8N_BASIC_AUTH_ACTIVE=true \
-e N8N_BASIC_AUTH_USER=admin \
-e N8N_BASIC_AUTH_PASSWORD=strongPassword \
-v ~/.n8n:/home/node/.n8n \
n8nio/n8n - Kubernetes（公式 Helm chart）
bash
helm repo add n8n https://charts.n8n.io
helm install my-n8n n8n/n8n
注: 外部リンクは執筆時点で有効でしたが、将来的に変更される可能性があります。実装前に URL が正しいかご確認ください。
2. AI ノードの全体像と選び方
2026 年現在、n8n が公式に提供している主な AI 接続ノード は次の３つです。各ベンダーが提供するモデルは随時更新されるため、実装時には「利用可能な最新モデル」を確認してください。
| ベンダー | ノード名（公式） | 主な対応モデル例* | 代表的なユースケース |
|---|---|---|---|
| OpenAI | OpenAI (旧称 ChatGPT) | GPT‑4o、GPT‑3.5‑turbo 等 | カスタマーサポート要約、文章生成、コード補完 |
| Anthropic | Claude | Claude 3 Opus、Claude 3 Haiku 等 | 長文要約・議事録作成、クリエイティブライティング |
| Gemini | Gemini 1.5 Pro 系列等 | 多言語翻訳、コード生成、画像＋テキストのマルチモーダル処理 |
*モデル名は執筆時点で公表されているものです。実際に利用できるかは各プロバイダーのコンソールでご確認ください。
2‑1. ノード選定のポイント
| 条件 | 推奨ノード |
|---|---|
| コスト重視・大量テキスト | Claude Haiku（トークン単価が低め） |
| リアルタイム対話やコード補完 | OpenAI GPT‑4o |
| 多言語対応・画像入力も必要 | Google Gemini |
計算例: 「トークン単価 × 予想月間使用量」で概算コストを出し、予算と照らし合わせて選択すると失敗が減ります。
3. API キーの安全管理（シークレット & 環境変数）
3‑1. シークレット機能で鍵情報を暗号化保存
- Credentials → New Credential → API Key を選択。
- 名前例
OPENAI_API_KEY、取得したキーを貼り付けて Save。
シークレットは n8n の内部ストレージに暗号化され、ワークフロー実行時のみ復号されます。
3‑2. 自己ホスト版での環境変数活用例
|
1 2 3 |
export N8N_OPENAI_API_KEY=sk-xxxxxxxxxxxx docker run -e N8N_OPENAI_API_KEY=$N8N_OPENAI_API_KEY -p 5678:5678 n8nio/n8n |
Workflow の OpenAI ノードで「Authentication」→「Credential」を選び、先ほど作成したシークレットを指定すれば完了です。
3‑3. 運用上のベストプラクティス
- 最小権限ロールでキーを発行し、不要になったら即座にローテーション。
- CI/CD パイプラインでは環境変数だけを参照し、コードリポジトリに鍵が残らないよう徹底する。
4. 手順で学ぶ「テキスト要約」ワークフロー（OpenAI ノード使用）
4‑1. フローレイアウト
| ステップ | ノード種別 | 主な設定 |
|---|---|---|
| 1 | Webhook | HTTP POST、レスポンスは 200 OK |
| 2 | Set（抽出） | {{$json["body"]}} を text フィールドに格納 |
| 3 | OpenAI（要約） | Model: gpt-4o（または利用可能な最新モデル）System Prompt: 「以下の文章を300文字以内で要点だけまとめて」 temperature: 0.2、max_tokens: 250 |
| 4 | Google Sheets / MySQL 等保存先 | 必要項目（件名・要約・実行日時）をレコード化 |
4‑2. デバッグ手順
- ワークフロー右上の Execute Workflow → Run Node をクリックし、各ノード単体でテスト。
- Execution List に表示される JSON 入出力を確認し、期待通りか検証。
- エラーは赤字ハイライト。必要に応じて Error Trigger と Function (Retry) を組み合わせて再実行ロジックを追加。
4‑3. カスタマイズ例
max_tokensは入力テキスト長に応じて動的計算（JavaScript Function ノードで文字数÷4 など）- プロンプトは「要点だけ」から「感情分析を加えて」へと変更可能
5. 応用ユースケース ― カスタムコードで高度化
5‑1. メール自動要約 ＋ kintone 連携
- Gmail Trigger → 新着メール取得
- Set：
subject・body抽出 - OpenAI（要約）
- Function（重要度判定）
|
1 2 3 4 5 6 |
// 重要度判定ロジック例 const summary = $json["summary"]; const keywords = ["緊急", "至急", "対応必要"]; const priority = keywords.some(k => summary.includes(k)) ? "High" : "Normal"; return { json: { ...$json, priority } }; |
- kintone ノードでレコード作成（件名、要約、優先度）
5‑2. チケット分類 AI エージェント
- 件名に特定タグがあれば Claude、それ以外は OpenAI を自動選択する仕組み
|
1 2 3 |
const useClaude = $json["subject"].includes("[内部]"); return { json: { model: useClaude ? "claude-3-opus" : "gpt-4o" } }; |
- 生成された
model値を次の OpenAI / Claude ノードの「Model」フィールドにマッピングすれば、件名だけでモデル切替が可能。
6. 本番運用のベストプラクティス
| 項目 | 推奨実装 |
|---|---|
| トークン・レートリミット対策 | 前処理で max_tokens をテキスト長に合わせて自動算出し、超過時は「分割」ノードへ分岐。429 エラー検知後は指数バックオフで再試行（Function ノード + setTimeout）。 |
| モニタリング | n8n の Execution Statistics と各プロバイダーの使用量ダッシュボードを定期的に比較。閾値超過時は Slack / Teams に通知。 |
| エラーハンドリング | Error Trigger → Function でエラー内容を整形し、メール/チャットへアラート送信。 |
| ログ保持・削除 | GDPR 等に準拠するため、実行履歴は 30 日程度で自動削除（N8N_EXECUTIONS_DELETE_AFTER_DAYS 環境変数）。 |
| 機密情報マスキング | 入力テキストに個人情報が含まれる場合は Replace ノードで正規表現置換し、AI へ送信前にマスク。 |
6‑1. デプロイ手順（ステージング → 本番）
- ステージング環境でユニットテスト的に各ノード単体・統合テストを実施。
- テストが完了したら Export → Import で Production ワークスペースへ移行。
- Cron ノードで定期実行（例：毎日 09:00）を設定し、開始時に Slack 通知でステータス報告。
7. トラブルシューティングと追加リソース
| 症状 | 主な原因 | 対処法 |
|---|---|---|
| 「401 Unauthorized」 が出る | API キーがシークレットに未設定、または環境変数名ミス | Credential を再確認し、N8N_<PROVIDER>_API_KEY の形式で設定 |
| 要約が途中で切れる | max_tokens 設定が低すぎる |
入力テキスト長に合わせて max_tokens を増やすか、分割処理を追加 |
| レートリミット（429）頻発 | 同時実行数が多い、または短時間に大量呼び出し | 「Concurrency」設定で同時実行数制限、リトライロジックの導入 |
参考リンク（執筆時点で有効）
- n8n 公式ドキュメント – https://docs.n8n.io
- OpenAI API リファレンス – https://platform.openai.com/docs/api-reference
- Anthropic Claude ドキュメント – https://docs.anthropic.com/claude
- Google Gemini API ガイド – https://developers.google.com/gemini
※ 上記リンクは執筆時点で確認済みです。将来的に URL が変更されることがありますので、利用前に公式サイトで最新情報をご確認ください。
8. まとめ
- n8n はノーコード/ローコードで業務フローを構築できる汎用自動化プラットフォーム。クラウド版と自己ホスト版のどちらでも導入が容易です。
- AI ノード（OpenAI・Claude・Gemini）はそれぞれ得意分野が異なるため、コスト・リアルタイム性・マルチモーダル対応などの要件で選択します。
- API キーは シークレット機能 と 環境変数 で安全に管理し、最小権限と定期ローテーションを徹底してください。
- 本稿の「テキスト要約」フローは、Webhook → Set → OpenAI → 保存というシンプルな構成で、すぐに実装可能です。カスタムコードノードを活用すれば、優先度判定やモデル自動切替といった高度なロジックも数行で追加できます。
- 本番運用では トークン上限・レートリミット対策、エラーハンドリング、モニタリング を必ず組み込み、ログ保持ポリシーに沿ったクリーンアップを実施しましょう。
これらのポイントを押さえておけば、n8n と最新 AI モデルを組み合わせた自動化が安全・安定・効果的に運用できます。ぜひ本ガイドを参考に、業務効率化プロジェクトに挑戦してみてください。
スポンサードリンク