Conditionalノード
Conditionalノードは、実行時の条件評価に基づいて出力ブランチのうち1本を選び、そのターゲットを活性化し、他のブランチターゲットはskippedとしてマークします。
ワークフローの進路がランタイムデータに依存するとき(件数・スコア・分類結果・成功/失敗フラグなど)に使います。すべてのブランチを並行実行したい固定分岐では、素直に直列エッジを引く方がよいです。
判断そのものは手前のノードではなく Conditional に書いてください。 Script ノードが {"new_items": 3} を出し、Conditional が new_items ≥ 1 で分岐すれば、判断基準がキャンバス上に見えます。Script ノードが自分で判断して {"skip": false} を出すと、基準はスクリプトの中に隠れてしまいます。
| フィールド | 説明 |
|---|---|
condition_type | 条件評価方法。rules / field / regex / llm のいずれか(下記参照)。 |
condition_rules | condition_type: rules のとき。{ when, label } の順序付きリスト。 |
condition_expression | それ以外の型のとき。ドットパス・パターン・プロンプト。 |
branches | ラベル→ターゲットノードIDのマップ。評価で得たラベルに対応するターゲットが活性化。 |
default_branch(任意) | 使えるラベルが得られなかったときの遷移先ノードID。 |
rules(推奨) — 構造化された比較を上から順に評価します。条件がキャンバス上に表示され、保存時に各フィールドが incoming edge の contract と照合されます。field—.categoryや.meta.routeのようなドットパス1つ。その値を文字列化してブランチラベルに使います。式言語ではありません。パイプ・比較・if/then/elseは評価されず、保存時に拒否されます。regex—status:\s*(?<label>\w+)を入力データに当てます。名前付きキャプチャlabelが使われます。llm— 分類プロンプト。LLMにブランチラベルのどれかを出力させます。必ずdefault_branchと併用してください。
jq は field の旧名として古いワークフローに残っています。動作は同じで、元からドットパスしか読みませんでした。
ルールの書き方
Section titled “ルールの書き方”各ルールは、すべて成立する必要のある条件リスト(when)と、成立したときに取るラベル(label)の組です。最初に成立したルールが採用され、when が空のルールは常に成立します — これが末尾の「それ以外」の書き方です。
condition_type: rulescondition_rules: - when: - { field: .new_items, op: gte, value: 1 } - { field: .locked, op: eq, value: false } label: generate - when: [] label: skipbranches: generate: write-blog skip: end使える演算子:
| 演算子 | 意味 | 値 |
|---|---|---|
eq / ne | 等しい / 等しくない | スカラー値 |
gt / gte / lt / lte | 大小比較 | 数値、または辞書順で比較される文字列(ISO日付がそのまま比較できます) |
in | いずれかに一致 | リスト |
contains | リストが値を含む、または文字列が部分文字列を含む | スカラー値・部分文字列 |
exists | フィールドが存在し null でない | — |
empty | 不在・null・""・[]・{} | — |
or はありません。選択肢ごとにルールを分けて書いてください。本当に計算が必要な判断はScriptノードで計算し、その結果で分岐してください。
値が存在しないフィールドとの比較は、エラーではなく単に不成立になります。一方で、数値と文字列のように比較できない型同士の比較はノードを失敗させます — 黙って別の枝に行くことはありません。
- cascadeがConditionalに到達すると、自身を
runningとして確保し、入力データに対して条件を評価します。 - 得られたラベルを
branchesで引いてターゲットノードIDを決定。使えるラベルが無ければdefault_branchを使用。 - 選ばれなかった全ての出力エッジのターゲットは
skippedとして挿入(下流のJoinが確定したことを認識できるように)。 - 選ばれたターゲットはレジストリ経由で活性化(ネストされたfan-out/conditionalでも種別固有の起動ロジックが走る)。
- Conditionalは
completedで確定し、output_dataに_chosen_branchと_target_nodeが記録され、監査可能になります。
遷移先がまったく決まらなかった場合、ノードは**failed**となり、理由がoutput_data._condition_errorに記録され、実行全体が失敗します。default_branchが救った場合も理由は記録されます(作者の意図どおりに分岐していないため)。
バリデーションルール
Section titled “バリデーションルール”condition_typeは必須。branches(非空)またはdefault_branchのいずれかが必要。branchesが参照するターゲットはすべて実在するノード。branchesの各ラベルに対して、ターゲットへの出力エッジが存在する。- 出力エッジの
condition_labelが設定されている場合、それはbranchesのラベルのいずれかと一致する必要があります。 default_branchを設定する場合、実在するノードを参照すること。rulesの場合: 各ルールのlabelがbranchesに存在すること、値を要する演算子に値があること、inがリストであること、whenが空のルールより後ろにルールが無いこと(到達不能になるため)。rulesかつ incoming edge が1本で contract を持つ場合: 各fieldがその contract に宣言されており、演算子と値が宣言された型と噛み合うこと。fieldの場合: 式がドットパスであること。regexの場合: パターンがコンパイルできること。
flowchart LR Classify["Skill: classify-ticket"] --> C{{"Conditional"}} C -->|bug| Bug["Skill: bug-triage"] C -->|feature| Feat["Skill: feature-intake"] C -->|other| Other["Skill: fallback"]condition_type: llm で「bug / feature / other に分類」するプロンプトを与えれば、LLMの出力がブランチを選びます。default_branch: other を設定すると、想定外のLLM出力にも耐えられます。