ワークフロー(グラフ実行)
ワークフローは、人間が Web UI で設計する Node / Edge グラフ です。 制御とデータフローは決定的に実行され、Agent Node の LLM 出力は JSON Schema で検証されて 型付きで後続 Node へ渡されます。
自由文をその場で LLM が解釈する Task Agent とは異なり、 ワークフローは「あらかじめ人間が設計した定型フロー」を繰り返し実行する用途に向いています。
向いている用途
仕様で想定されている代表例:
- 機能追加の計画 → レビュー → 改稿 → 実行 — Planner が計画し、Reviewer の判定で改稿ループを回し、承認後に実行する。
- 文脈付きリサーチ — Vault / 活動 / 既存テーマを読み取り、テーマを整えてからリサーチを実行し、結果を保存する。
- 定型タスクの承認付き自動化 — 人間が設計した Capability グラフを手動実行する。
入口
| 操作 | 場所 |
|---|---|
| 一覧・新規作成・テンプレートから作成 | /workflows |
| ユーザーテンプレートの利用・編集・削除・import / export | /workflows(ユーザーテンプレート領域) |
| Revision 履歴・最近の Run | /workflows/:workflowId |
| 公開 Revision の Template 保存・JSON / YAML export | /workflows/:workflowId |
| グラフエディタ | /workflows/revisions/:revisionId/edit |
| Run 詳細 | /workflows/runs/:runId |
API は /api/v1/workflows/... 配下で、他の API と同じ Bearer トークン認証を要求します。
基本の流れ
flowchart LR
A[Workflow を作成] --> B[draft Revision を編集]
B --> C[検証]
C -->|OK| D[公開 published]
D --> E[Run 作成]
E --> F{plan_required / Agent を含む?}
F -->|はい| F2{承認スキップ有効?}
F -->|いいえ| H[自動実行]
F2 -->|いいえ| G[waiting_approval で承認待ち]
F2 -->|はい| H
G -->|承認| H
H --> I[完了 / 未完了 / 失敗]
- Workflow を作成すると、空の
draftRevision が 1 つ作られます。 - エディタで Node と Edge を組み、
inputs_schemaを定義します。 - 検証 に合格したら 公開 します。公開した Revision は不変になります。
- 実行入力を入れて 実行 します。
plan_requiredの Capability か Agent Node を含む場合はwaiting_approvalになり、Run 詳細で 承認 するまで実行されません。 Workflow 詳細で 承認なしで実行する を有効にした Workflow は承認なしで実行されます。 - Run 詳細で進捗・Node 状態・出力・Event を確認します。
Workflow の改名・削除
Workflow 詳細(/workflows/:workflowId)から本体を管理できます。
- 改名・説明・承認設定の変更 — ヘッダーの「編集」で名前・説明・ 承認なしで実行する を変更し「保存」します。名前は空にできません。
- 削除 — ヘッダーの「Workflow を削除」で確認後、Workflow 定義と実行履歴をまとめて削除します。
次の場合は削除できません(先に解消してください)。
- 実行中の Run(承認待ち・HITL 待ち・要確認待ちを含む終端していない Run)が残っている。
- Scheduler Job の対象になっている。ジョブ側で対象を変更または削除してください。
削除は取り消せません。実行履歴も一緒に消えるため、残したい場合は削除しないでください。 個別の Revision(下書き・旧版)だけを消す場合は、Revision 行の「削除」を使います (公開済み Revision は削除できません)。