メインコンテンツまでスキップ

Run・承認・復旧

Run を作成する​

Run は published Revision からのみ 作成できます。 Workflow 詳細の 公開中の Revision で 開く を押し、エディタの 実行入力 に 値を入れて 実行 を押します。実行入力は式({"$expr": ...} の日付式)にも対応しています。 API では POST /api/v1/workflows/revisions/:revision_id/runs を使います。

入力は Revision の inputs_schema で検証されます。スキーマで default を設定した項目は、 入力が空のときその値が自動で補完されます(ネストした object も対象)。

承認​

次のいずれかを含む Run は、作成時に waiting_approval になります。

  • 承認ポリシーが plan_required の Capability Node
  • Agent Node(Agent を含む Run は常に承認が必要)

Run 詳細(/workflows/runs/:runId)で 承認 を押すと queued になり、実行が始まります。 auto Capability だけの Run は承認なしで実行されます。

承認なしで実行する(Workflow 単位)​

Workflow 詳細の編集で 承認なしで実行する を有効にすると、その Workflow の Run は Agent Node や plan_required Capability を含んでいても waiting_approval にならず、 作成と同時に実行待ち(queued)になります。Scheduler Job からの起動も承認なしで走ります。

  • 設定は Workflow 本体にあり、全 Revision に適用されます。
  • 判定は Run 作成時に一度だけ行われ、設定変更後に作成済みの Run には影響しません。
  • スキップで作成した Run には run_approval_skipped イベントが記録されます。
  • Agent は実行時点の最新設定で動くため、有効化すると現在および将来の Agent 権限での 副作用が無承認で実行されます。無人の定期実行で外部操作が起きうる点に注意してください。
Agent の権限は実行時点の設定です

Agent Node は実行時点の最新の Agent 設定(system prompt・model・許可ツール)で動きます。 承認 UI は「現在および将来の Agent 権限で実行される」ことを前提として扱ってください。 開始時の設定指紋は workflow_events に記録されます。

Run 詳細の見方​

セクション内容
ヘッダーRun ID と状態。状態に応じた操作ボタン。
概要作成日時、結果要約、エラー要約、実行入力の JSON。
グラフ実行時スナップショットの読み取り専用グラフ。Node ごとの状態表示と実行回数。
Node選択中 Node の status / attempt / 入出力(入力・出力・エラー)。Agent 子 Run を持つ Node は実行したツール名と回数、および個々の LLM コールへのリンクも表示。未選択時は全 Node。
Events追記のみの監査イベント一覧。

グラフ表示とノード選択​

  • グラフは Run 作成時の graph_snapshot を使った読み取り専用表示です。ドラッグや編集はできません。
  • 各 Node の状態は、その Node の最新 Activation の最後の attempt から決まります(retry や Loop 反復を含みます)。
  • 1 つの Node が複数回実行された場合(Loop・再実行)は実行回数を表示します。
  • Node をクリックすると、その Node だけの Activation・attempt・入出力履歴に絞って表示します。完全な Node ID は選択詳細に表示されます。「選択を解除」で全 Node の履歴に戻ります。
  • 各 Node 行の 入出力 列は折りたたみ表示です。閉じた状態では短いプレビューと入力/出力の文字数が見え、 行をクリックすると保存済みの 入力・出力・エラー を全文で確認できます(JSON は整形表示、 JSON でない値はそのまま表示、値がない区分は省略)。各行は独立して開閉できるため、前段 Node の出力と 後段 Node の入力を同時に開いて比較できます。生成画像カードと子 Run のツール要約は、折りたたみ状態に かかわらず行内に表示されます。
  • Agent 子 Run を持つ Node では、ツール要約の下にその Agent Run が行った LLM コールが 時系列で表示されます。各リンクは実行ログの該当詳細を直接開きます。ログは 30 日間 保持されるため、 それより古い Run や、この帰属機能より前に実行された Run ではリンクが表示されません (Agent / Workflow の履歴自体は残ります)。
  • 条件分岐で通過した Edge は記録されないため、Edge は定義どおりに表示し、通過状態の強調はしません。
  • スナップショットを持たない旧 Run ではグラフを表示せず、従来どおり全 Node の履歴を表示します。

進捗は SSE(GET /api/v1/workflows/runs/:run_id/stream)で自動更新されます。 切断時は last-event-id により差分から再開し、完了・待機状態に達するとストリームは閉じます。

状態に応じた操作​

Run 状態操作
waiting_approval承認
interrupted再開
非終端取消
waiting_attention採用して続行 / 再実行 / 失敗として処理 / 中断
終端(completed / incomplete / failed / cancelled)再実行(Rerun)

取消(キャンセル)​

取消はロールバックではなく要求です。 実行中の外部処理へ取消を伝えますが、強制停止や 処理の巻き戻し(exactly-once 保証)は行いません。すでに起きた副作用は取り消されません。

  • queued / waiting_approval / waiting_hitl / waiting_attention なら即時に cancelled。
  • running なら cancelling(画面表示は 停止要求中)を経て、外部処理の停止を確認できた 場合に cancelled へ。
  • 取消要求後に外部処理が完了していた、または結果が確認できない場合は cancelled に せず、waiting_attention(要確認)になります。次 Node 以降は実行されません。
  • waiting_hitl の取消では、関連する HITL Run も取消され、遅れて届いた回答で Run が再開 されることはありません。
  • 実施済みの副作用は巻き戻しません(自動ロールバックは行いません)。
  • 自動 retry(backoff_seconds)の挙動は今回変更しません。取消要求の直後に同一 Node が retry して副作用が重複する可能性は残ります(後続の InvocationContext 導入で扱います)。

中断と再開​

  • Web サーバー(worker)停止時、その instance が所有する running / cancelling Run は interrupted になります。
  • waiting_approval / waiting_hitl / waiting_attention は維持されます。
  • interrupted は自動再実行されません。再開 で queued に戻します。
  • 完了済み Node は Activation 単位で重複実行されません。

HITL 待ち​

  • hitl_wait Capability は HITL へ質問を登録し、Node を waiting_hitl、Run を waiting_hitl にします。
  • worker の claim は解放されます。回答は既存の 確認待ち(/hitl)画面で行います。
  • 回答後、回答値が型付き出力として返り、Node は succeeded になります。

needs_attention(非冪等 Node の中断・取消後の不確実結果)​

Agent / Coding / リサーチなどの非冪等 Node が外部操作中に中断した場合、または取消要求後に 外部処理が完了・結果不明になった場合、自動再開せず次の状態になります。

  • Node: needs_attention
  • Run: waiting_attention

Run 詳細では、要確認の理由(外部処理が完了済みか結果不明か)と、確認すべき子 Run の 種別・ID・確認先へのリンクが表示されます。

人間は次のいずれかを選びます。

  1. 採用して続行 — 子 Run が実際に成功済みで、出力 schema と Effect を再検証できる場合のみ有効。 取消起因の場合は、保存済みの成功出力または効果の証跡があるときだけ採用でき、証跡が なければ 409 で拒否されます。採用時は保存済みの出力を再利用し、再実行はしません。
  2. 再実行 — 新しい Activation として再実行する。重複副作用の可能性がある。
  3. 失敗として処理 — error Edge があればそこへ進み、なければ Run を failed にする。

証跡がない取消起因の要確認では、採用はできません。失敗として処理・中断(一覧に戻る) ・再実行のいずれかを選んでください。

再実行(Rerun)​

終端 Run は、その graph_snapshot と inputs を引き継いだ新しい Run として再実行できます。

  • 元 Revision が superseded でも、スナップショットを複製するため再実行できます。
  • 再実行 を押すと入力フォームが開きます。入力は上書きでき、inputs_schema で検証されます。省略時は元 Run の入力をコピーします。
  • 承認要否はスナップショットの Node 集合から再判定されます。
  • 新しい Run は source_run_id で元 Run を参照し、run_rerun_created イベントが記録されます。
  • 非終端 Run は再実行できません(409)。

Run を削除する​

終端 Run(完了・未完了・失敗・取消)は、Workflow 詳細の Run 一覧または Run 詳細の 削除 から 実行履歴を削除できます。確認後、Run・Node・Activation・Event がまとめて削除されます。

  • 非終端 Run は削除できません(409)。先に取消などで終端にしてください。
  • 削除は取り消せません。監査目的で残す場合は 30 日の保持期間に任せてください。
  • Scheduler 発火や one-shot の記録行は残り、Run へのリンクだけが外れます(一覧では「削除済み」と表示)。
  • 子の Agent / Research / Coding / HITL 実行は削除されません。それぞれの画面から確認できます。

保持期間と機密情報​

  • 終端 Run とその Node・Activation・Event は 30 日後 に削除されます。非終端 Run は削除されません。
  • 入力・出力・エラーは既知の設定済み秘密値を redact して保存します。
  • Run 入力に API キーなどの秘密値を入れないでください。 資格情報は Capability 側で実行時に注入されます。

worker の動作​

Workflow worker は Web サーバーの FastAPI lifespan に同居します。 Web サーバー停止中は新しい Run の実行が進みません。 再起動後に 再開 してください。

次に読む​