ビルドタイムとランタイム
ワークフローには2つの異なるフェーズがあります:ビルドタイム
エディタでワークフローを設計する段階。ステップの定義、ツールの設定、依存関係の構成を行います。
ランタイム
ランナーがマニフェストを解釈し実行する段階。ステップが依存関係順に実行され、データが流れます。
実行タイムライン
ワークフローが実行されると、以下のタイムラインに従います:1
トリガー
API呼び出し、スケジュール、MCP、または手動実行で開始
2
検証
入力パラメータを検証、マニフェストを読み込み
3
実行
依存グラフに従ってステップを実行
4
処理
エラーをキャッチ、設定されていればリトライを試行
5
返却
最終結果を呼び出し元に返す
ステップ実行パターン
直列
依存関係のあるステップが順番に実行
並列
独立したステップが同時に実行
条件分岐
when条件がtrueの場合のみ実行ループ
forEachで各アイテムに対して繰り返し実行直列実行
needsを持つステップは依存関係を待ちます:
step_a → step_b → step_c
並列実行
共有の依存関係がないステップは並列に実行されます:input → (branch_a ∥ branch_b) → merge
条件分岐実行
条件ロジックにはwhenを使用:
ループ実行(forEach)
forEachでコレクションを処理:
障害モード
ステップ状態
各ステップは以下の状態を遷移します:変数解決
変数は実行時に解決されます:エラー処理のベストプラクティス
- 早期検証:INPUT_*ツールを使用して開始時にデータを検証
- 出力チェック:重要な操作の後に検証ステップを追加
- 条件の使用:
when句で異なる結果を処理 - 障害への設計:外部サービスが失敗した場合を考慮
- 履歴のレビュー:実行履歴を使用して障害を分析
デバッグのヒント
次のステップ
ワークフローのデバッグ
デバッグ技術を学ぶ
YAMLリファレンス
マニフェスト構文の完全リファレンス