DAGノード
HQのビジュアルエディタで作るワークフローは、種別を持つノードをエッジでつないだDAGです。ノード種別ごとに実行セマンティクスと設定項目が異なります。
ノード種別一覧
Section titled “ノード種別一覧”| 種別 | 用途 |
|---|---|
| Start | エントリセンチネル。トリガーペイロードを受け取る。 |
| End | エグジットセンチネル。グラフの終了地点を示す。 |
| Skill | ミニオン上でスキル(LLMタスク)を実行。 |
| Review | 人間またはミニオンによる承認ゲート(差し戻しループ付き)。 |
| Fan-out | 入力配列に対してサブグラフを展開実行。 |
| Join | 複数入力のバリア。上流出力を集約する。 |
| Conditional | 条件に応じて1つのブランチに分岐。 |
| Transform | 2つのエッジContract間をLLMで橋渡しする。 |
| Script | PythonまたはNode.jsのインラインスクリプトを実行(LLMなし、決定的)。 |
ノード同士の関係
Section titled “ノード同士の関係”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 .-> AStartとEndはセンチネルで、エディタが自動挿入するためノードパレットには出現しません。それ以外のノード種別はすべて、エディタ左側のパレットからドラッグ&ドロップで配置します。
共通フィールド
Section titled “共通フィールド”すべてのノードは、プロパティパネルの共通ヘッダに以下のフィールドを持ちます(種別固有セクションは各ノードのページを参照)。
| フィールド | 説明 |
|---|---|
id | グラフ内(およびテンプレート内)でユニークな安定識別子。 |
label | キャンバス上に表示される人間向けの名前。 |
assigned_role | 旧ロール。任意。新しいステップには無く、プロジェクトのメンバーのミニオンならどれでも実行します。特定のミニオンに任せたいステップは、プロジェクトのワークフローの画面の ステップの担当 で固定できます(固定はそのプロジェクトにだけ効きます)。古いワークフローのステップに旧ロールが残っていても使われず、そのステップもプロジェクトのどのミニオンでも実行します。 |
種別固有の設定は、各ノードのページで解説します。
ステップが失敗したとき
Section titled “ステップが失敗したとき”失敗したステップには、実行のページに失敗の理由が出ます。
| 表示 | 何が起きたか |
|---|---|
| タイムアウト | ステップが制限時間を超えた。 |
| 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 回実行されると困るステップは、そのステップのプロパティで「このステップは再試行しない」にチェックを入れます。
- 設定はワークフローと一緒に保存されるので、公開した後に始まる実行から有効になります。
外に公開する
Section titled “外に公開する”ワークフローの形は、ワークスペースの外の人にも公開できます。エディタの 公開 はワークスペースの中で使う版を確定する操作で、外への公開とは別です。外への公開は公開共有を、外から何が見えるかは公開されるものを参照してください。