3行でいうと
- n8nの基本は、1つの「トリガー」から始まるノードの流れ(ワークフロー)です。公式は、ノードの種類を、トリガー、アクション、コアノード、クラスターノード、コミュニティノードに分けて説明しています。
- AIは、「AI Agent」ノードにチャットモデルとツールをつなぐ形で組み込みます。公式は、AI Agentノードに最低1つのツールをつなぐ必要がある、と書いています。
- 新しい「Agents」(エージェントを画面で組み立てる機能)と「n8n Assistant」(チャットでワークフローを作らせる機能)は、公式が「Preview」と書いています。Previewの区別は落とさないでください。
- AIが使うツールの1つ1つに、人の承認を挟むことができます。公式は、取り消せない操作や外への送信に向く、と書いています。
- 「Ask n8n AI」は、公式が「もう積極的には開発されていない」と書いています。チャットで作るなら、n8n Assistantが案内されています。
この記事は、公式の資料を2026年10月23日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。画面名やメニュー名は公式の表記を写しています。公式ページは要約の形で取得したため、読めていない部分は「公式の資料では確認できていない」「読んだ範囲では見つからなかった」と書きます。僕らの見立てや使い分けの提案は、必ず「見立て」と書いて、事実と分けます。
先に結論
- n8nは「流れ作業のライン」を自分で組むツール。 ベルトコンベアの上に、「受け取る」「判断する」「加工する」「送る」の部品を並べる、というイメージです(たとえは僕らの整理です)。
- 最初は、きっかけが決まった小さな流れから。 公式のチュートリアルは、毎朝8時に天気を取り込み、報告文にして、表に記録する4つのノードだけの流れです。
- AIは、流れの中の「判断する部品」として入る。 AI Agentノードが、つながれたツールの中から、必要なものを自分で選んで使います。
- AIに全部を任せない仕組みもある。 ツールの実行前に承認を求める、入力や出力を検査する(Guardrails)、人に引き継ぐ、といった部品が公式に書かれています。
- 新しい機能にはPreviewが多い。 現時点の公式の表記では、Agents、n8n Assistant、n8n packagesが「Preview」です。
前提:用語をそろえる
- ノード(node):流れの中の1つの部品です。公式は、トリガーのノードを「ワークフローを動かすきっかけになる特別なノード」と書いています。
- アクション(action):データを加工する、外のシステムに働きかける、他のシステムでイベントを起こす、といった操作です。
- コアノード(core node):特定の外部サービスに結びつかず、ロジック、スケジュール、汎用のAPI呼び出しなどを担うノードです。
- クラスターノード(cluster node):「ルートノード」1つに、機能を足す「サブノード」が付いた組です。AI関連の多くは、この形です。
- 式(expression):前のノードのデータを、文章や設定の中に差し込む書き方です。公式のチュートリアルは
{{ $json.city }}のような形を使っています。 - エージェント(agent):公式は、AIの言語モデルが「どの行動を取るかを決める」部品と説明し、決まった順に呼び出すだけの「チェーン」と区別しています。
- MCP:AIのツールが、外のツールやデータにつながる共通の規格です。03で扱います。
たとえ話:厨房の「持ち場」
n8nは、厨房の持ち場のようなものです。「注文が入る」(トリガー)、「材料を切る」(データの加工)、「味を見て分ける」(条件分岐)、「盛りつけて出す」(外への送信)と、持ち場をつなぎます。AI Agentは、メニューにない注文が来たとき、棚のツール(ツール)から自分で選んで作る料理人です。人の承認は、「このお客さんには、店長が確認してから出す」という決まりに当たります。たとえは僕らの整理で、公式の説明ではありません。
機能と使い方の場面
場面1:決まった時刻に、データを集めて記録する
- できること:公式の「Build your first workflow」は、Schedule Trigger、HTTP Request、Edit Fields (Set)、Data tableの4つで、毎日8時に天気を取り、報告文を作り、表に1行足す流れを作ります。
- 公式のどこに書かれているか:「Build your first workflow」のページ(約15分、ほかのアカウントやAPIキーは不要)。
- 試すツール:ノードの「Execute step」で1つずつ動かし、全体を「Execute workflow」で試し、よければ「Publish」します。
- 見立て:最初の1本は、公式のように、外から取る・文章にする・どこかに残す、の3段にすると、全体の流れがつかみやすいと僕らは考えます(見立て)。
場面2:外からの合図で動かす(Webhook)
- できること:公式の「Webhook」ノードは、外のアプリやサービスからデータを受け取って、ワークフローを始める部品です。流れの最後で作ったデータを返して、API(外から呼べる窓口)のように使うこともできます。専用のトリガーがないサービスからでも、動かせます。
- 公式のどこに書かれているか:「Webhook node」のページ。
- 決まり:「Test URL」(試すとき。エディタにデータが出る)と「Production URL」(公開したあと。エディタには出ず、「Executions」のタブで見る)の2つがあります。対応するHTTPメソッドはDELETE、GET、HEAD、PATCH、POST、PUT。最大のデータ量は16MBで、セルフホストでは環境変数で変えられます。
- 守り:認証は「Basic auth」「Header auth」「JWT auth」「None」から選べます。IPの許可リスト、ボットの無視、「Only Run If」(条件に合うときだけ動かす)などの設定もあります。公式は、公開した窓口を守るには、認証かIPの制限、または両方を使うよう案内しています。
- 見立て:Webhookは外に開いた窓なので、最初は認証を入れる設定にして、中身を確かめる習慣をつけるのが安全だと考えます(見立て)。
場面3:条件で分ける、まとめる、繰り返す、待つ
- できること:公式の「Flow logic」のページは、次の部品を挙げています。
- 分ける:IF、Switch
- まとめる:Merge、Compare Datasets、Code
- 繰り返す:Loop Over Items(IFと組み合わせる)
- 待つ:Wait(途中で止めて、あとで再開する)
- 部品に分ける:サブワークフロー(Execute Workflow、Execute Workflow Trigger)
- 失敗に備える:Stop And Error、Error Trigger(失敗したときに動く「エラーワークフロー」)
- 公式のどこに書かれているか:「Flow logic」のページ。
- ノードごとの設定:公式の「Work with nodes」は、「Retry On Fail」(失敗したら再実行)、「On Error」(Stop Workflow/Continue/Continue (using error output))、「Execute Once」、「Always Output Data」を挙げています。「Always Output Data」は、IFノードで使うと、無限ループになることがある、と注意書きがあります。
- 読めていない所:各ノードの個別のページの中身(Switchの細かい設定など)は、今回読めていません。
場面4:データを加工する、コードを書く、表に残す
- できること:公式は、データを扱う手段として、式、データの種類を扱う専用ノード、Codeノード、「Data tables」を挙げています。
- 式とUIのマッパー:前のノードの値を、ドラッグで差し込みます。
- ピン留めとモック:公式の目次に「Pin and mock data」があります。外のサービスに触れずに、同じデータで試せます(中身は今回読めていません)。
- Codeノード:コードを書いて加工します。公式の目次に、AIからコードの助けを得る「Get coding help from AI」があります(本文は今回読めていません)。
- Data tables:プロジェクトの中に、表の形で残す機能です。公式は、実行をまたいで残す、二重実行を防ぐ印を持つ、プロンプトを使い回す、AIの評価データを置く、早見表にする、といった用途を挙げています。
- 公式のどこに書かれているか:「Data tables」のページと「Work with data」の目次。
- 決まり(Data tables):インスタンス全体の合計で、既定は200 MiBまで。80%で警告が出て、上限に達すると、手での追加が止まり、データを書き込むワークフローの実行も失敗します。セルフホストでは環境変数
N8N_DATA_TABLES_MAX_SIZE_BYTESで変えられます。CSVの取り込みと書き出し(「Import CSV」「Download CSV」)ができます。Codeノードは、表の値に直接アクセスできません。 - 見立て:大きなデータの倉庫にするのではなく、「小さなメモ帳」として使うツールだと、公式の上限の書き方からは読めます(見立て)。
場面5:AI Agentに、ツールを選ばせて仕事をさせる
- できること:公式の「AI Agent」ノードのページは、「AI Agent」ノードで、チャットモデルと1つ以上のツールをつなぎ、エージェントが、どのツールを呼ぶかを決めて仕事をこなすと書いています。ツール用のサブノードを少なくとも1つつなぐ必要があります。
- 公式のどこに書かれているか:「AI Agent node」「What agents do」「LangChain in n8n」「Understand AI components」のページ。
- チェーンとの違い:「What agents do」のページは、チェーンを「決まった順の呼び出し」、エージェントを「言語モデルで、取る行動を決めるもの」として区別しています。
- 部品の分類:「LangChain in n8n」のページは、次のように整理しています。ルートノードは、チェーン(Basic LLM Chain、Question and Answer Chain、Summarization Chain)、エージェント(AI Agent)、ベクトルストア(Pinecone、Qdrant、Simple Vector Store)。サブノードは、言語モデル、メモリー、ツール、リトリーバー、埋め込み(Embeddings)、ドキュメントローダー、出力パーサー、テキスト分割です。n8nのAIノードは、LangChainの「JavaScript」版の仕組みを使っている、と書かれています。
- 制限:メモリーのサブノードは、AI Agentのルートノードにだけつながります。どのチェーンのノードもメモリーに対応せず、会話の過去のやりとりを参照できません。会話を覚えさせたいなら、エージェントを使う、と書かれています。
- 種類の変更:AI Agentノードの「エージェントの種類」の設定は、n8n 1.82.0から非推奨で、今のAI Agentノードはすべて「Tools Agent」として動きます。種類の設定があるバージョン1のノードは、n8n 3.0で削除される予定、と書かれています。
- 読めていない所:AI Agentノードのページには、パラメーターとオプション、人の確認の機能の説明は、読んだ範囲では見つかりませんでした。
場面6:エージェントを画面で組み立てる(Agents、Preview)
- できること:公式の「Build and manage agents」のページは、エージェントを、言語モデル、指示、機能を持つ自律的なアシスタントと書いています。ワークフローと並んでプロジェクトに置き、「決まった流れでは手に負えない、開かれた仕事」に使う、とされています。推論の繰り返しの中で、ツールを呼ぶ、ナレッジを検索する、サブエージェントに任せる、追加で質問する、を選びます。
- 構成要素(公式の表):Model、Instructions、Tools(ワークフロー、独自コード、組み込みの連携、MCPサーバー)、Web search、Skills、Channels(Slack、Telegram、Linear)、Schedules(時間ごと、毎日、毎週、毎月、またはcron)、Sub-agents、Knowledge base(csv、pdf、markdown、txt)、Memory(会話中のSessionと、過去の会話のEpisodic)。
- 作り方:プロジェクトの「Agents」タブで「Create Agent」。変更は下書きに自動保存され、「Preview」で試し、「Publish」で公開します。公開された版だけが、利用者、チャンネル、スケジュールに使われます。
- Previewの注意:公式は、エージェントは「Preview」で、間違えることがあり、動きが変わる可能性がある、と書いています。自分で動かすセルフホストでは、n8n 2.32.3から全プランで使え、ナレッジはPreviewで、コードを動かす場所(サンドボックス)が要ります。キューモードには、まだ対応していない、とも書かれています。
- 数え方:1回のやりとり(1つのメッセージと返事)が、1回の実行として数えられ、ワークフローと同じ実行の枠を使います。
- 設定の切り替え:「Settings > Agents」の「Enable Agents」で、オーナーや管理者が、インスタンス全体で入り切りできます。
場面7:AIの行動に、人の承認や検査を挟む
- 人の承認:公式の「Human-in-the-loop for tools」のページは、AI Agentがあるツールを実行する前に、ワークフローを止めて、人に「Approve」か「Deny」を求められると書いています。向く場面として、データの削除、外へのメッセージ送信、購入などの取り消せない操作、規制のある業種、影響の大きい判断を挙げ、「最初は承認ありで始めて、信頼できてきたら減らす」という使い方も書いています。承認の届け先は、Chat、Slack、Discord、Telegram、Microsoft Teams、Gmail、WhatsApp Business Cloud、Google Chat、Microsoft Outlookです。タイムアウトや待ち時間の上限は、そのページには書かれていませんでした。
- 入力や出力の検査:公式の「Guardrails」ノードは、文章を、AIに渡す前や、AIの出力を使う前に検査する部品です。「Check Text for Violations」(違反があれば「Fail」の枝へ)と「Sanitize Text」(URL、正規表現、秘密鍵、個人情報などを、置き換え文字に変える)の2つの操作があります。検査の種類は、Keywords、Jailbreak、NSFW、PII、Secret Keys、Topical Alignment、URLs、Custom、Custom Regexです。LLMを使う検査には、チャットモデルのノードをつなぐ必要があります。しきい値(Threshold)は0.0〜1.0の数字で、高いほど厳しい(Jailbreakの項目の説明)と書かれています。
- 公式のどこに書かれているか:「Human-in-the-loop for tools」と「Guardrails」のページ。
- 見立て:外に送るメールや、お金に関わる操作のツールには、承認を必ず挟む使い方が、公式の挙げる場面とも合っていると考えます(見立て)。
場面8:AIに、ワークフローを作ってもらう
公式の「Ways of building workflows」は、5つの方法を挙げています。
| 方法 | 公式の説明 | 状態(公式の表記) |
|---|---|---|
| n8n Assistant | チャットで、ワークフローの作成、編集、テスト、原因探しをする | Preview(間違えることがある。動きが変わりうる) |
| n8n MCP server | Claude DesktopやClaude Codeなどから、ワークフローを作って動かす | 該当ページに、ベータの表記は見つからず(エージェントの管理はPreview) |
| Templates | 空のキャンバスの代わりに、できあがった流れから始める | 記載なし |
| Ask n8n AI | エディタの中の助けを得る | 公式が「no longer actively developed」と書く |
| Chat Hub | 複数のAIモデルとn8nのエージェントと、1つの画面でチャットする | ページにPreview・ベータの表記は見つからず |
- n8n Assistantの利用可能範囲:n8n Cloudの「Starter」「Pro」、セルフホストの「Community」「Registered Community」「Business」。EnterpriseはまだPreviewのアクセスを相談する段階、と公式に書かれています。
- AI Workflow Builder:公式に、文章の説明から、ワークフローを作る、直す、原因を探す機能として別のページがあります。作成や変更を頼むメッセージ1回が、1「interaction」(1クレジット)で、月の上限があります(数字はそのページには書かれていません)。ただし、「Ways of building workflows」の一覧には載っておらず、n8n Assistantとの関係は、読んだ範囲では確認できていません。なお、Ask n8n AIのページには、「Send actual data values」をオフにするとAI Workflow Builderも使えなくなる、と書かれています。
- Ask n8n AI:n8n Cloudの全プランで使えて、セルフホストでは使えない、と書かれています。「Settings > AI Usage」の「Send actual data values」で、実際のデータの値を送るかどうかを、オーナーや管理者が決められます。
- Chat Hub:ナビゲーションの「Chat」から始めます。公式のChat Hubのページは、Chat Hub自体のプラン別の可否は書いていませんが、「Chat user」ロールについて、n8n Cloudの全プランと、セルフホストのBusiness・Enterpriseで使える形で書いています。モデルの提供元は、管理者が「Settings > Chat」で入り切りし、利用者が自分のモデルや認証情報を足すのを止めることもできます。自分用のエージェント(「Personal Agents」)を作ったり、Chat Triggerのあるワークフローを、「Make Available in n8n Chat」でエージェントとして出したりできます。ワークフローをエージェントにするには、AI Agentノードの「Enable Streaming」を有効にして、公開します。ワークフローを触らせずにチャットだけ使わせる「Chat user」ロールがあります。
- 公式のどこに書かれているか:「Ways of building workflows」「n8n Assistant」「AI Workflow Builder」「Ask n8n AI」「Chat Hub」のページ。
場面9:できあがった流れから始める(Templates)
- できること:公式の「Use templates」は、n8nとコミュニティの人が作った流れを、n8nのサイトで探して使える、と書いています。作るときに「空のワークフロー」か「既存のテンプレート」を選び、「Templates」のアイコンでライブラリを開きます。使うには、認証情報を入れたり、設定を直したりする必要があることがある、と書かれています。
- 今後の予定:公式は、n8nが制作者向けのプログラムとテンプレートのマーケットプレイスを準備中で、内容は変わりうる、と書いています。
- 自分の組織のライブラリ:セルフホストで、環境変数
N8N_TEMPLATES_HOSTに自分のAPIを指定し、独自のテンプレート置き場を使えます。 - 注意:そのページには、安全面の明確な注意書きは、読んだ範囲では見つかりませんでした。誰かが作ったテンプレートは、中のノードとつながり方を確認してから動かすのが無難、というのは僕らの見立てです。
場面10:動かしたあとに、見る・直す
- 実行の履歴:公式の「Understand executions」は、実行を1回ずつ記録し、「ワークフロー単位」と「すべて」の一覧で見られると書いています。過去の実行のデータを、今のワークフローにコピーして直す「Debug and re-run」、AIの出力を生成しながら返す「Streaming」、入力と出力を隠す「Redaction」が、関連機能として挙げられています。
- 実行の数え方(有料プランの上限):公式は、数えるのは本番の実行(トリガー、スケジュール、ポーリングで始まるもの)だけと書いています。Schedule Triggerは、結果にかかわらず1回ごと。ポーリングは、新しいデータが見つかったときだけ。Webhookは、受け付けた1回ごと。数えないものは、手動の実行、サブワークフローの呼び出し(親だけが数えられる)、エラーワークフローの実行、新しいデータがないポーリングです。
気をつけること
- この記事は、実際に使って確かめた記録ではありません。公式のドキュメントなどを読んだ範囲です。
- 「Agents」「n8n Assistant」「n8n packages」は、公式が「Preview」と書いています。「Ask n8n AI」は、公式が積極的な開発はもうしていないと書いています。仕様が変わる可能性が高いので、最新の公式の資料で確かめてください。
- 公式のドキュメントの中で、AI Workflow Builder、n8n Assistant、Ask n8n AIの関係(どれが後継か)は、ページごとに書き方が違い、読んだ範囲では1つにまとまりませんでした。
- 場面ごとの細かい設定(各ノードの個別のページ、Evaluations、Code nodeの個別機能など)は、今回の読み込みの範囲外です。
- AIが作った流れや、AIの答えは、確かめてから使ってください。n8nのAI規約は、利用者が出力の正しさを自分で確かめる責任を持つ、と書いています(04で扱います)。
出典
- Build your first workflow(n8n Docs、確認日 2026-10-23)
- Node types(n8n Docs、確認日 2026-10-23)
- Work with nodes(n8n Docs、確認日 2026-10-23)
- Flow logic(n8n Docs、確認日 2026-10-23)
- Understand executions(n8n Docs、確認日 2026-10-23)
- Webhook node(n8n Docs、確認日 2026-10-23)
- Data tables(n8n Docs、確認日 2026-10-23)
- Integrate AI(n8n Docs、確認日 2026-10-23)
- Understand AI components(n8n Docs、確認日 2026-10-23)
- What agents do(n8n Docs、確認日 2026-10-23)
- LangChain in n8n(n8n Docs、確認日 2026-10-23)
- AI Agent node(n8n Docs、確認日 2026-10-23)
- Build and manage agents(n8n Docs、確認日 2026-10-23)
- Human-in-the-loop for tools(n8n Docs、確認日 2026-10-23)
- Guardrails node(n8n Docs、確認日 2026-10-23)
- Ways of building workflows(n8n Docs、確認日 2026-10-23)
- n8n Assistant(n8n Docs、確認日 2026-10-23)
- AI Workflow Builder(n8n Docs、確認日 2026-10-23)
- Ask n8n AI(n8n Docs、確認日 2026-10-23)
- Chat Hub(n8n Docs、確認日 2026-10-23)
- Use templates(n8n Docs、確認日 2026-10-23)
- n8n Docs 索引 llms.txt(n8n Docs、確認日 2026-10-23)