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 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/cancellingRun はinterruptedになります。 waiting_approval/waiting_hitl/waiting_attentionは維持されます。interruptedは自動再実行されません。再開 でqueuedに戻します。- 完了済み Node は Activation 単位で重複実行されません。
HITL 待ち
hitl_waitCapability は 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・確認先へのリンクが表示されます。
人間は次のいずれかを選びます。
- 採用して続行 — 子 Run が実際に成功済みで、出力 schema と Effect を再検証できる場合のみ有効。
取消起因の場合は、保存済みの成功出力または効果の証跡があるときだけ採用でき、証跡が
なければ
409で拒否されます。採用時は保存済みの出力を再利用し、再実行はしません。 - 再実行 — 新しい Activation として再実行する。重複副作用の可能性がある。
- 失敗として処理 — 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 の実行が進みません。 再起動後に 再開 してください。