Skip to main content
実行モデルを理解することで、信頼性の高いワークフローを設計し、問題を効果的にデバッグできます。

ビルドタイムとランタイム

ワークフローには2つの異なるフェーズがあります:

ビルドタイム

エディタでワークフローを設計する段階。ステップの定義、ツールの設定、依存関係の構成を行います。

ランタイム

ランナーがマニフェストを解釈し実行する段階。ステップが依存関係順に実行され、データが流れます。

実行タイムライン

ワークフローが実行されると、以下のタイムラインに従います:
1

トリガー

API呼び出し、スケジュール、MCP、または手動実行で開始
2

検証

入力パラメータを検証、マニフェストを読み込み
3

実行

依存グラフに従ってステップを実行
4

処理

エラーをキャッチ、設定されていればリトライを試行
5

返却

最終結果を呼び出し元に返す

ステップ実行パターン

直列

依存関係のあるステップが順番に実行

並列

独立したステップが同時に実行

条件分岐

when条件がtrueの場合のみ実行

ループ

forEachで各アイテムに対して繰り返し実行

直列実行

needsを持つステップは依存関係を待ちます:
実行順序: step_astep_bstep_c

並列実行

共有の依存関係がないステップは並列に実行されます:
実行順序: input → (branch_abranch_b) → merge

条件分岐実行

条件ロジックにはwhenを使用:
分類結果に基づいて1つのハンドラーのみが実行されます。

ループ実行(forEach)

forEachでコレクションを処理:
ステップはコレクション内の各アイテムに対して1回実行されます。

障害モード

ステップ状態

各ステップは以下の状態を遷移します:

変数解決

変数は実行時に解決されます:

エラー処理のベストプラクティス

  1. 早期検証:INPUT_*ツールを使用して開始時にデータを検証
  2. 出力チェック:重要な操作の後に検証ステップを追加
  3. 条件の使用when句で異なる結果を処理
  4. 障害への設計:外部サービスが失敗した場合を考慮
  5. 履歴のレビュー:実行履歴を使用して障害を分析

デバッグのヒント

次のステップ

ワークフローのデバッグ

デバッグ技術を学ぶ

YAMLリファレンス

マニフェスト構文の完全リファレンス