コンテンツにスキップ

Conditionalノード

Conditionalノードは、実行時の条件評価に基づいて出力ブランチのうち1本を選び、そのターゲットを活性化し、他のブランチターゲットはskippedとしてマークします。

ワークフローの進路がランタイムデータに依存するとき(件数・スコア・分類結果・成功/失敗フラグなど)に使います。すべてのブランチを並行実行したい固定分岐では、素直に直列エッジを引く方がよいです。

判断そのものは手前のノードではなく Conditional に書いてください。 Script ノードが {"new_items": 3} を出し、Conditional が new_items ≥ 1 で分岐すれば、判断基準がキャンバス上に見えます。Script ノードが自分で判断して {"skip": false} を出すと、基準はスクリプトの中に隠れてしまいます。

フィールド説明
condition_type条件評価方法。rules / field / regex / llm のいずれか(下記参照)。
condition_rulescondition_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 の旧名として古いワークフローに残っています。動作は同じで、元からドットパスしか読みませんでした。

各ルールは、すべて成立する必要のある条件リスト(when)と、成立したときに取るラベル(label)の組です。最初に成立したルールが採用され、when が空のルールは常に成立します — これが末尾の「それ以外」の書き方です。

condition_type: rules
condition_rules:
- when:
- { field: .new_items, op: gte, value: 1 }
- { field: .locked, op: eq, value: false }
label: generate
- when: []
label: skip
branches:
generate: write-blog
skip: end

使える演算子:

演算子意味値
eq / ne等しい / 等しくないスカラー値
gt / gte / lt / lte大小比較数値、または辞書順で比較される文字列(ISO日付がそのまま比較できます)
inいずれかに一致リスト
containsリストが値を含む、または文字列が部分文字列を含むスカラー値・部分文字列
existsフィールドが存在し null でない—
empty不在・null・""・[]・{}—

or はありません。選択肢ごとにルールを分けて書いてください。本当に計算が必要な判断はScriptノードで計算し、その結果で分岐してください。

値が存在しないフィールドとの比較は、エラーではなく単に不成立になります。一方で、数値と文字列のように比較できない型同士の比較はノードを失敗させます — 黙って別の枝に行くことはありません。

  1. cascadeがConditionalに到達すると、自身をrunningとして確保し、入力データに対して条件を評価します。
  2. 得られたラベルをbranchesで引いてターゲットノードIDを決定。使えるラベルが無ければdefault_branchを使用。
  3. 選ばれなかった全ての出力エッジのターゲットはskippedとして挿入(下流のJoinが確定したことを認識できるように)。
  4. 選ばれたターゲットはレジストリ経由で活性化(ネストされたfan-out/conditionalでも種別固有の起動ロジックが走る)。
  5. Conditionalはcompletedで確定し、output_dataに_chosen_branchと_target_nodeが記録され、監査可能になります。

遷移先がまったく決まらなかった場合、ノードは**failed**となり、理由がoutput_data._condition_errorに記録され、実行全体が失敗します。default_branchが救った場合も理由は記録されます(作者の意図どおりに分岐していないため)。

  • 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出力にも耐えられます。