第10章 ノードの種類

この章では、ワークフロー・チャットフローの編集画面（キャンバス）に置けるノード（処理の部品）を、種類ごとに説明します。主要な7つのノードの役割と使いどころは、第3章〜第6章で説明しました。この章は、置ける全ノードの一覧と、各ノードの設定項目をまとめたリファレンスです。最初から順に読むほか、アプリを作りながら「このノードは何をするのか」を引く一覧としても使えます。

• 本章は、序章「本書の確認環境」のとおり、クラウド版の公式ドキュメント（docs.dify.ai）のノード一覧にある全ノードを掲載しています（確認日：2026-08-14）。
• ノードを配置・接続・設定する画面操作は第7章で説明します。ツール・プラグインの導入は第11章、エラーが出たときの対処は第14章で説明します。
• ナレッジ（保管庫）への資料の登録のしかたや検索の設定は第5章で説明します。本章では、ノードとしての役割にしぼって説明します。

10-1. ノードの全体像（一覧）

本書では、ノードを働きに応じて次の4つに分けて説明します。この分け方は本書の整理です（公式ドキュメントは、ノードを分類せずに1つずつ並べています）。

ノードの間のデータの受け渡しは 変数（ノードが出した値に名前を付けて、後ろのノードから参照できるようにしたもの）で行います。変数の考え方は第4章4-1で、受け渡しの操作は第7章で説明します。

全ノードの一覧は次のとおりです。

この20ノードのうち、ユーザー入力ノード（ユーザー入力）・LLM・知識検索・回答／出力・IF/ELSE・質問分類器・変数集約器が、第3章〜第6章で役割と基本の使い方を説明した主要な7つのノードです（第3章3-1。回答と出力はアプリの種類で使い分けるため、一覧では2行に分かれています）。それ以外のノード（テンプレート・ツール・コード・HTTPリクエスト・パラメータ抽出・イテレーションなど）は、基本の7つのノードに慣れてから使う発展的なノードです（第3章3-5）。

アプリの種類によって、使えるノードに次の違いがあります。

10-2. 基本のノード（入口・AIの呼び出し・出口）

ユーザー入力ノード（Start）

処理の入口になるノードです。ワークフロー・チャットフローは必ずここから始まります。役割と入力欄の基本の設定は第4章4-1で説明しています（本書の他の章では「ユーザー入力ノード」と表記。第3章3-1）。

このノードだけは、アプリを作った時点で最初からキャンバスに置かれています。 処理の入口は1つと決まっているため、ノードを追加する一覧には表示されず、追加も削除もできません。設定を変えて使うノードです。

開始のしかたは2つのモードから選びます。

• ユーザー入力（User Input）：利用者（またはAPI呼び出し）が求めたときに動かします。利用者から受け取る入力欄をここで定義します。
• トリガー（Trigger）：決まった時刻や外部の出来事をきっかけに、自動で動かします。トリガーを使えるのはワークフローだけで、チャットフローは常にユーザー入力で始まります。

主な設定項目（ユーザー入力）

• 入力欄の型：短文（256文字まで）／段落（長文）／選択（選択肢から選ぶ）／数値／チェックボックス／JSONコード（構造つきのデータ）／単一ファイル／ファイルリスト（複数ファイル）
• 非表示の欄：利用者に見せず、あらかじめ決めた値を渡す欄として使えます。ただし、秘密の情報（APIキー・パスワードなど）を入れる場所ではありません。値はURLに含まれ、利用者側から見える場合があります。

主な設定項目（トリガー）

• スケジュールトリガーは、1つのワークフローに1つまでです。1つのワークフローに複数のトリガーを置くこともできますが、置ける数や月あたりの実行回数の上限は契約プランにより異なります。

使いどころ：職員が文書を貼り付けて要約させるアプリはユーザー入力、毎朝決まった時刻に集計を動かすアプリはスケジュールトリガー、というように「人が動かすか、自動で動くか」で選びます。

LLM

AIモデル（LLM）を呼び出して、文章・画像・文書を処理させるノードです。要約・文案作成・言い換え・分類など、AIに考えさせる処理の中心になります。役割と基本の使い方（SYSTEM・USERの書き分け・変数の差し込み）は第4章4-2で説明しています。

主な設定項目

• モデル選択：お使いの環境に設定されているAIモデルから選びます。どのモデルを選べるかは環境の契約・設定によります。
• モデルのパラメータ：Temperature（温度。答えのばらつきの大きさ）などを調整できます。
• 指示文（プロンプト）の設定：AIへの指示を、システム（前提の指示）・ユーザー（入力）・アシスタント（応答例）の役割に分けて書き、前のノードの値を差し込めます。
• コンテキスト変数：知識検索の結果をつなぐと、登録した資料を根拠に探して答える仕組み（RAG）になります。
• メモリ：チャットフローで、前のやりとりを覚えたまま応答させる設定です。
• ビジョン機能設定：画像を入力に含めます（画像に対応したモデルが必要です）。
• 構造化出力：答えを、決めた項目立て（構造）で返させる設定です。

使いどころ：受け取った文書の要約、通知文の下書き作成、問い合わせへの回答文の生成など、文章を作る処理全般に使います。

知識検索（Knowledge Retrieval）

質問の文に関係する断片（チャンク）をナレッジ（保管庫）から探し出し、検索結果を後ろのノード（主にLLM）に根拠として渡すノードです。本書の他の章では、このノードを「知識検索ノード」と表記しています（第3章3-1）。役割と基本の使い方（LLMノードのコンテキストへのつなぎ方）は第5章で説明しています。

主な設定項目

• クエリテキスト：何を手がかりに探すか（通常は利用者の質問文の変数）を指定します。
• 検索対象のナレッジ：探しにいくナレッジを選びます。複数を同時に指定できます。
• 検索の調整：Top K（拾う件数）・スコアしきい値（関連度の合格ライン）・Rerankモデル（検索結果を関連度で並べ直す仕組み）などをノード単位で調整できます。
• メタデータフィルタ：文書に付けた属性で、探す範囲を絞り込めます。

検索結果は result という変数（拾った断片の一覧）で出力されます。ナレッジ側の登録・検索設定の考え方は第5章で説明します。

使いどころ：規程集・要綱を登録したナレッジから根拠を拾い、LLMに「拾った断片をもとに答える」ようにつなぐ、庁内FAQの中心部品です。

回答（Answer）

チャットフローで、利用者に見せる返事を組み立てて返すノードです。固定の文章と、前のノードの変数を組み合わせて返せます。チャットフロー専用で、ワークフローでは代わりに「出力」を使います（第3章3-1。出力ノードの基本の使い方は第4章4-3）。

主な設定項目

• 返事の内容：文章の中に変数を差し込んで書きます。文章・画像・ファイルを組み合わせて返せます。
• 複数配置：流れの途中に複数置き、段階的に返事を出すこともできます。並べた変数の順に、できたものから順次表示されます。

公式ドキュメント内には「答え」という表記もあります。画面の表示は環境・バージョンにより異なることがあります。

使いどころ：聞き取りの途中経過を返す、最後にまとめの回答を返すなど、チャットフローの「話す側」を担います。

出力（Output）

ワークフローで、処理結果の変数を利用者やAPIの呼び出し元に返すノードです。ワークフロー専用で、チャットフローでは代わりに「回答」を使います。役割と基本の設定手順は第4章4-3で説明しています。

主な設定項目

• 出力する変数：返したい値に名前を付けて割り当てます。1つのノードに最低1つの変数が必要で、付けた名前がAPIで返るときの項目名になります。
• 複数配置：ワークフロー内に複数置けます。実行されたすべての出力ノードの変数が1つの結果にまとめられるため、変数の名前はワークフロー全体で重複させないようにします。

使いどころ：要約の本文、審査結果の一覧など、ワークフローの最終結果を外に返す出口として使います。

10-3. 流れを分ける・繰り返すノード（ロジック）

IF/ELSE（If-Else）

条件に当てはまるかどうかで、処理の流れを分けるノードです。公式ドキュメントの表記は「If-Else」です。役割と基本の使い方（条件の考え方・質問分類器との使い分け）は第6章6-1・6-3で説明しています。

主な設定項目

• 分岐の経路：IF（条件に当てはまったとき）／ELIF（さらに別の条件を追加したとき）／ELSE（どの条件にも当てはまらなかったとき）の経路を持ちます。
• 条件：変数に対して「含む」「で始まる」「等しい」「空である」「より大きい」などの比べ方を指定します。
• 複数条件の組み合わせ：AND（すべて満たす）／OR（どれか1つ満たす）で組み合わせられます。

使いどころ：添付ファイルの有無で処理を変える、文字数が上限を超えたら別の経路に回す、といった「決まった条件による分岐」に使います。文章の意味による振り分けは、次の質問分類器が向いています。

質問分類器（Question Classifier）

入力された文章が、あらかじめ決めた分類（クラス）のどれに当たるかをAIが判定し、分類ごとの経路に振り分けるノードです。条件式では書きにくい「意味による振り分け」ができます。役割と基本の使い方（分類の説明の書き方・IF/ELSEとの使い分け）は第6章6-2・6-3で説明しています。

主な設定項目

• 入力変数：分類したい文章（通常は利用者の質問文）を指定します。
• モデル選択：判定に使うAIモデルを選びます。
• クラスの定義：分類ごとに、タイトル（画面上の表示）と説明（AIが判定の手がかりにする文章）を書きます。
• 指示：判断に迷いやすい場合の決め方など、判定の補足ルールを書けます。

使いどころ：問い合わせを「手続きの質問」「制度の質問」「その他」に振り分けて、それぞれ別のナレッジや返し方につなぐ、といった受付の入口に使います。

変数集約器（Variable Aggregator）

IF/ELSEや質問分類器で分かれた経路の結果を、1つの変数にまとめるノードです。実行のたびにどれか1つの経路だけが動くため、値が入っている変数がそのまま出力になります。これにより、分岐の数だけ後ろのノードを複製せずに済みます。本書の他の章では、このノードを「変数集約器」と表記しています（第3章3-1）。役割と基本のつなぎ方は第6章6-4で説明しています。

主な設定項目

• 集約する変数の選択：各経路から、同じ後処理につなぎたい変数を追加します。まとめる変数は同じデータ型である必要があります。
• グループ：複数の変数のまとまりを、それぞれ別々に集約したいときに使います。

使いどころ：質問分類器で3経路に分けてそれぞれLLMで答えを作った後、1つの「回答」ノードに合流させる、といった分岐の合流点に使います。

イテレーション（Iteration）

一覧（配列）の各項目に、同じ処理を1件ずつ適用するノードです。ノードの中に小さな処理の流れを作り、それを項目の数だけ繰り返します。公式ドキュメントでは「反復処理」とも表記されます。

主な設定項目

• 入力：繰り返しの対象になる配列の変数を指定します。
• 組み込み変数：繰り返しの中では、現在の項目（items）と何件目か（index）を参照できます。
• 処理モード：1件ずつ順に処理するか、並列（複数件を同時。最大10件）で処理するかを選べます。
• エラー処理：途中でエラーが出たとき、「終了（そこで止める）」「エラー時継続（失敗分を飛ばして続ける）」「失敗結果を除去（成功分だけ返す）」から選べます。

使いどころ：アップロードされた複数のファイルを1件ずつ要約する、一覧の各行に同じ整形をかける、といった「同じ処理の繰り返し」に使います。

ループ（Loop）

前回の結果を踏まえて同じ処理を繰り返し、条件を満たしたら抜けるノードです。イテレーションが「独立した項目への同じ処理の繰り返し」なのに対し、ループは「前の回の結果を引き継いで積み上げる繰り返し」に使います。

主な設定項目

• ループ変数：繰り返しをまたいで保持され、終了後も参照できる変数を定義します。
• ループ終了条件：どうなったら繰り返しをやめるかの条件です。
• 最大ループ回数：無限に繰り返さないための上限回数です。
• ループ終了ノード：繰り返しの中にこのノードを置くと、そこに到達した時点で繰り返しを抜けます。

繰り返しは、終了条件を満たす・最大回数に達する・ループ終了ノードが実行される、のいずれかで止まります。

使いどころ：作った文章をAIに自己点検させ、決めた水準を満たすまで直しを繰り返す、といった「仕上がるまで繰り返す」処理に使います。

人間の入力（Human Input）

処理の流れを一時停止し、人が内容を確認・記入し、次に進むかどうかを決めてから再開させるノードです。自動処理の途中に人の確認をはさめます。

主な設定項目

• 配信方法：確認のフォームを、Webアプリの画面に表示するか、メールでリンクを送るかを選びます。トリガーで始まるワークフローでは、Webアプリでの表示は使えません。
• フォーム内容：確認してもらう案内文（変数の差し込み可）と、記入欄（段落・選択・ファイルなど）を設定します。
• ユーザーアクション：「承認」「差し戻し」のような決定ボタンを定義し、押されたボタンによって後ろの経路を分けられます。
• タイムアウト戦略：期限（既定は3日）までに応答がなかったときに進む経路を設定します。

使いどころ：AIが作った通知文の下書きを、発送前に担当者が確認して承認する、といった「人の確認をはさむ自動化」に使います。

変数代入（Variable Assigner）

チャットフローで、会話変数（同じ会話の中で、やりとりをまたいで保持される値）に書き込むノードです。通常の変数は実行のたびにリセットされますが、会話変数は会話が続く間保持されます。

主な設定項目

• 書き込み先：どの会話変数を更新するかを選びます。
• 書き込む値：前のノードの出力などから指定します。
• 操作：上書き・設定・クリアのほか、数値には算術演算（足し引きなど）、配列には追加・拡張・最初/最後を削除、といった型に応じた操作を選べます。

使いどころ：聞き取りで集めた回答（申請者名・事業内容など）を会話変数にため、最後にまとめて下書きを作る、といった「覚えたまま進める対話」に使います。

10-4. データを変換するノード

テキスト抽出（Document Extractor）

アップロードされたファイルから文字を取り出し、AIモデルが読める文章にするノードです。AIモデルはPDFやWordのファイルをそのままは読めないため、ファイルを扱う流れではこのノードをはさみます。英語名はDocument Extractorです。

主な設定項目

• 入力：ファイル変数（1ファイル）またはファイルの配列（複数ファイル）を指定します。
• 出力：取り出した文章が変数 text に入ります。1ファイルなら1つの文字列、複数ファイルなら文字列の配列になります。

対応するファイル形式には、テキスト（TXT・Markdown・HTML）、Word（DOCX・DOC）、PDF（文字情報のあるもの）、Excel・CSV、PowerPoint、メールファイル（EML・MSG）などがあります。

使いどころ：申請書のPDFや報告書のWordファイルを受け取り、本文を取り出してLLMの要約・確認につなぐ、ファイル処理の最初の一歩に使います。

パラメータ抽出（Parameter Extractor）

自由に書かれた文章から、必要な項目をAIで取り出して構造化する（決めた項目立てのデータにする）ノードです。取り出した項目は、後ろのツールやHTTPリクエストにそのまま渡せます。

主な設定項目

• 入力変数：取り出し元の文章を指定します。
• モデル選択：取り出しに使うAIモデルを選びます。
• パラメータ定義：取り出したい項目ごとに、名前・データ型・説明・必須かどうかを定義します。
• 抽出指示：何をどう取り出すかの補足ルールを書けます。
• 推論モード：モデルの機能を使う方式（関数呼び出し／ツール呼び出し）と、指示文で指定する方式を選べます。

取り出せたかどうかは、組み込みの変数（成功したか・失敗の理由）で確認できます。

使いどころ：「来週の火曜に会議室を借りたい」といった相談文から日付・用件を取り出して、後ろの検索や外部システムへの連携に渡す、といった聞き取りの整理に使います。

テンプレート（Template）

複数の変数を、あらかじめ決めた文章の型に差し込んで整形するノードです。型の記述にはJinja2（ジンジャ2。文章の型に変数や簡単な処理を書き込める記法）を使います。

主な設定項目

• テンプレート本文：変数の差し込み（{{ 変数名 }}）のほか、条件による出し分け、繰り返し、フィルター（大文字化・四捨五入・結合など）が書けます。
• 入力変数：本文に差し込む変数を割り当てます。

使いどころ：件名・宛先・本文の変数を差し込んで通知文を組み立てる、複数ノードの結果を1つの報告書式にまとめる、といった定型の文章づくりに使います。プログラムを書かずに整形できるため、コード実行ノードより先に検討するとよい部品です。

コード実行（Code）

PythonまたはJavaScriptのプログラムを書いて、独自の計算・変換を行うノードです。用意されたノードだけでは書けない処理を補います。プログラムの経験がある職員向けの部品で、多くのアプリはこのノードなしで作れます。

主な設定項目

• 言語：PythonまたはJavaScriptを選びます。
• 入力変数・出力変数：プログラムに渡す変数と、返す変数を定義します。
• エラー処理・再試行設定：失敗時の再試行（最大10回・間隔は最大5000ミリ秒）と、失敗したときに進む経路を設定できます。再試行には必ず上限があります。

プログラムは隔離された実行環境（サンドボックス）で動き、ファイルの読み書き・外部への通信・システム操作はできません。出力の長さにも上限があります（文字列は40万文字まで）。

使いどころ：独自の集計・複雑な文字列変換など、他のノードで表現できない処理が本当に必要なときにだけ使います。

リスト処理（List Operator）

一覧（配列）から、条件に合う項目の絞り込み・並べ替え・取り出しをするノードです。複数ファイルの入力を種類ごとに分けるときによく使います。

主な設定項目

• フィルタリング：種類（タイプ）・MIMEタイプ（ファイルの種類を表す符号）・拡張子・ファイルサイズ・ファイル名などの条件で絞り込みます。
• ソート：昇順（ASC）／降順（DESC）で並べ替えます。
• 選択：最初のN個を取得（1〜20件）・最初のレコード・最後のレコードを取り出せます。

結果は result（絞り込み後の一覧）・first_record（最初の1件）・last_record（最後の1件）の変数で出力されます。

使いどころ：複数の添付ファイルから画像だけを選んで画像向けの処理へ、文書だけをテキスト抽出へ、と経路を分ける入口に使います。

10-5. 外部と連携するノード

外部のシステム・サービスとつながるノードです。庁内ネットワークから外部に接続できるかは環境によるため、利用の前に情報担当部署に確認してください（第11章）。

HTTPリクエスト（HTTP Request）

外部のシステム・サービスに、HTTP（Webの通信のきまり）で要求を送り、結果を受け取るノードです。外部のデータの取得、外部システムへの通知・登録などに使います。

主な設定項目

• メソッド：要求の種類（GET＝取得、POST＝送信 など6種類）を選びます。
• URL・ヘッダー：送り先と付帯情報を設定します。変数を差し込めます。
• 認証：認証なし／APIキー（送り方は数種類から選択）を設定します。APIキーなどの秘密の値は、原稿や共有資料に直接書かないでください。
• リクエスト本文：送るデータ（JSON・フォームデータなど）を設定します。
• タイムアウト設定：接続・読み取り・書き込みそれぞれの待ち時間の上限を設定します。
• リトライ設定・エラー処理：失敗時の再試行（最大10回・間隔は最大5000ミリ秒）と、失敗したときに進む経路を設定できます。再試行には必ず上限があります。
• レスポンス：応答の本文・ステータスコード（処理結果を表す3桁の番号）・ヘッダーなどが変数で受け取れます。

使いどころ：庁内の別システムのAPI（外部のシステムから機能を呼び出す窓口）にデータを渡す、外部の公開データを取りにいく、といった連携に使います。具体的な使い方は第11章で説明します。

ツール（Tool）

Web検索・外部サービス連携などの外部機能（ツール）を、処理の流れの中の1部品として呼び出すノードです。使えるツールは、プラグイン（Difyに機能を追加する部品）を入れることで増えます。

主な設定項目

• ツールの選択：キャンバスのノード追加からツールを選びます。
• 認証情報：ツールが必要とする認証情報（アカウントの接続やAPIキー）を選択または作成します。
• ツールごとの設定：選んだツールに応じた項目（検索語など）を設定します。

使いどころ：最新の情報のWeb検索、外部サービスへの投稿・通知など、既製の外部機能をそのまま使いたいときに便利です。ツールの種類と導入のしかたは第11章で説明します。

エージェント（Agent）

目的と使えるツールを与えると、AIがどのツールをいつ使うかを自分で判断し、考える→実行する→結果を見る、を繰り返して仕事を進めるノードです。手順を固定できない調べものに向きますが、動きが読みにくくなるため、手順が決まっている処理は通常のノードのつなぎで作るほうが確実です。

主な設定項目

• エージェント戦略：ツールの使い方の判断方式を選びます（モデル自身の機能で呼び出す方式＝Function Callingと、考えと行動を交互に書かせる方式＝ReActがあります）。
• モデル選択：判断に使うAIモデルを選びます。
• ツール設定：使わせるツールと、その説明・認証を設定します。
• 指示とコンテキスト：エージェントの役割・目的を文章で与えます。
• 最大反復回数：繰り返しの上限です。無限に動き続けないための安全装置なので、必ず設定を確認します。

使いどころ：複数の情報源を調べて突き合わせる下調べなど、「何をどの順で調べるか」を事前に決めにくい作業に使います。

10-6. 掲載範囲と表記の注意

• 本章の20ノードは、確認日（2026-08-14）時点でクラウド版の公式ドキュメントのノード一覧に掲載されている全ノードです。本書で扱わないノードはありません。お使いの画面に本章にない名前のノードがある場合や、本章のノードが見当たらない場合は、バージョン・環境（セルフホスト版など）の違いです。章末の出典一覧から公式ドキュメントの最新の記載を確認してください。
• ループの中で使う「ループ終了」は、単独のノードではなくループの内部の部品として10-3で説明しました。
• 公式ドキュメントの一部には、「出力」の旧称にあたる「End（終了）」、「回答」を指す「答え」、「イテレーション」を指す「反復処理」の表記が残っています。また、「統合トリガー」を指す「インテグレーショントリガー」の表記も公式の日本語ページにあります。本書では「出力」「回答」「イテレーション」「統合トリガー」で統一します。画面の表示名は環境・バージョンにより異なることがあります。

出典一覧

本章の記述の根拠です（いずれも確認日：2026-08-14）。各ノードは英語版（en）と日本語版（ja）の公式ドキュメントで確認しました。