コンテンツにスキップ

DAGノード

HQのビジュアルエディタで作るワークフローは、種別を持つノードをエッジでつないだDAGです。ノード種別ごとに実行セマンティクスと設定項目が異なります。

種別用途
Startエントリセンチネル。トリガーペイロードを受け取る。
Endエグジットセンチネル。グラフの終了地点を示す。
Skillミニオン上でスキル(LLMタスク)を実行。
Review人間またはミニオンによる承認ゲート(差し戻しループ付き)。
Fan-out入力配列に対してサブグラフを展開実行。
Join複数入力のバリア。上流出力を集約する。
Conditional条件に応じて1つのブランチに分岐。
Transform2つのエッジContract間をLLMで橋渡しする。
ScriptPythonまたはNode.jsのインラインスクリプトを実行(LLMなし、決定的)。
flowchart LR
S(("Start")) --> A["Skill: fetch"]
A --> C{{"Conditional"}}
C -->|ok| T["Transform"]
C -->|error| E(("End"))
T --> F[["Fan-out"]]
F --> J(("Join"))
J --> R{"Review"}
R -->|approved| E
R -. revision .-> A

StartとEndはセンチネルで、エディタが自動挿入するためノードパレットには出現しません。それ以外のノード種別はすべて、エディタ左側のパレットからドラッグ&ドロップで配置します。

すべてのノードは、プロパティパネルの共通ヘッダに以下のフィールドを持ちます(種別固有セクションは各ノードのページを参照)。

フィールド説明
idグラフ内(およびテンプレート内)でユニークな安定識別子。
labelキャンバス上に表示される人間向けの名前。
assigned_role旧ロール。任意。新しいステップには無く、プロジェクトのメンバーのミニオンならどれでも実行します。特定のミニオンに任せたいステップは、プロジェクトのワークフローの画面の ステップの担当 で固定できます(固定はそのプロジェクトにだけ効きます)。古いワークフローのステップに旧ロールが残っていても使われず、そのステップもプロジェクトのどのミニオンでも実行します。

種別固有の設定は、各ノードのページで解説します。

失敗したステップには、実行のページに失敗の理由が出ます。

表示何が起きたか
タイムアウトステップが制限時間を超えた。
LLM の認証切れミニオンの LLM の CLI がログインしていない、または鍵が拒否された。誰かがログインし直す必要がある。
LLM が使えない (混雑・上限・残高)LLM が混雑していた、利用回数や使用量の上限に達した、または残高が足りなかった。
実行エラーLLM の CLI がエラーで終了した。
出力なしステップが出力を提出しないまま終わった。
Contract 違反出力がエッジの Contract に合わなかった。
「完了できない」と宣言ステップ自身が、タスクを完了できないと報告した。
起動できなかったステップのセッションを始められなかった。
スクリプトの失敗Script ノードがエラーで終了した、JSON でないものを出力した、または時間切れになった。
ミニオンの応答が途絶えたステップを実行していたミニオンから 5 分間応答がなかった。実行はいつまでも待たずに先へ進む。
手動で失敗にした誰かが「失敗にする」を押した。
実行を停止した誰かが実行を止めた。

失敗したステップの自動再試行

Section titled “失敗したステップの自動再試行”

エディタの Settings タブで「失敗したステップを自動で再試行する」をオンにすると、もう一度試せば直りうる理由で失敗したステップを、ワークフローが自動でやり直します。最大試行回数は、最初の実行を含めて 2〜5 回から選びます。再試行のたびに LLM を使うので、既定ではオフです。

  • 再試行するもの: ミニオンの応答が途絶えた、タイムアウト、LLM が使えない、実行エラー、起動できなかった、出力なし、Contract 違反。
  • 再試行しないもの: LLM の認証切れ (誰かがログインし直すまで同じ結果になる)、「完了できない」と宣言、スクリプトの失敗、手動で失敗にした、実行を停止した。
  • 次の試行は、1 回目の失敗の 1 分後、それ以降は 5 分後に始まります。ステップには、前の試行がなぜ失敗したかが伝わります。
  • 再試行されたステップは、実行のページで「試行 2/3」のように表示され、その下に前の試行が並びます。
  • メール送信など、2 回実行されると困るステップは、そのステップのプロパティで「このステップは再試行しない」にチェックを入れます。
  • 設定はワークフローと一緒に保存されるので、公開した後に始まる実行から有効になります。

ワークフローの形は、ワークスペースの外の人にも公開できます。エディタの 公開 はワークスペースの中で使う版を確定する操作で、外への公開とは別です。外への公開は公開共有を、外から何が見えるかは公開されるものを参照してください。