サイクルとワークフロー
プロジェクトには、サイクルとワークフローがあります。違うのは、動き方です。マーケットプレイス版では、プロジェクトを作るときの型の既定はワークフローです。
このページでは、それぞれがどう動くのかと、型によって何が変わるのかを説明します。どちらを選ぶかの基準は設計ガイドにあります。
ワークフローは 1 件(案件)が流れて終わる
ワークフローは、1 件の実行が工程を順に進んで、終わります。マーケットプレイス版では、この 1 件を案件と呼びます。工程は直列に進み、並列に分かれるレーンはありません。条件分岐の工程では、前の工程の結果で選んだレーンだけを通ります。
終わり方は 4 つです。最後の工程まで進めば完了、確認工程で却下されれば却下、人が止めれば中断、先へ進めなくなれば失敗になります。どの終わり方でも、そこで 1 件が閉じます。起動できなかったときは、案件は失敗として終わります(案件ガイド)。閉じた案件をやり直すときは、新しく案件を開始します。
サイクルは配置ごとに動き続ける
サイクルには、開始も終了もありません。止めるまで動きます。
巡回を有効にした配置が、それぞれに決めた周期で動きます。 周期のほかに、Webhook で起動することもできます。ほかの配置が終わるのを待ちません。ある工程の配置が動いている間に、別の工程の配置がまったく違う周期で動いていることもあります。
サイクルには、確認工程・条件分岐・外部の自動化の工程は置けません。 人の判断を挟む業務や、結果で進む先を分ける業務は、ワークフローで作ります。
ここが誤解されやすいところです。工程が輪のように並んで見えても、その並びは実行される順番ではありません。順に回っていく仕組みではなく、それぞれが自分の周期で動いていると考えてください。同じ配置が実行中のあいだに来た回は見送られ、積み上げて動かすことはありません(起動ガイド)。
一番の違いは「1 件」の区切り
型の違いを一言でいうと、「1 件」という区切りがあるかどうかです。
ワークフローには区切りがあります。案件として、始まりから終わりまでをひとまとまりで追えるので、「あの依頼はどうなったか」が分かります。案件は設定と成果物をバージョンで持ち、確認工程ではそのバージョンを見て判断します(案件ガイド)。
サイクルには区切りがありません。記録は巡回のたびに残りますが、それらをまとめた「1 件」はありません。追えるのは「いつ何が動いたか」で、「あの依頼はどうなったか」ではありません。サイクルに置けるのは、会話で使う登録 Agent で、契約も認定も要りません。
次に読むもの
- 誰が何を決められるか — プロジェクトの役割と、案件の操作
- 人の確認 — 確認工程で何を決めるのか
- 設計ガイド — どちらの型を選ぶか、工程をどう分けるか
- 起動ガイド — 型ごとに、いつ動かすかを決める