メインコンテンツへ移動
ドキュメント走る手動実行

ワークフローを手動で実行する

エディタで「実行」をクリックするか、一覧から一括実行し —— 右側のリアルタイムイベントストリームを読み解きます。

手動実行は、ワークフローを実行するための最も基本的な方法です。開発とデバッグ、1 回限りのビジネス要件、および定期的および予定外のレポートはすべてこの入り口を使用します。この記事では「どこをクリックすればいいのか、ダイアログボックスの各項目は何なのか、実行後に何が表示されるのか」を分かりやすく解説しています。

3 つの手動実行入口

1. エディターの「実行」をクリックします。

最も一般的に使用されます。ワークフローを変えてすぐに試してみたいあなたに最適です。

2. ワークフローリストカードの「▶ 実行」をクリックします

すでに安定しており、エディターを開きたくないワークフローに適しています。

3. バッチ実行

ワークフローリストの上部にある複数の項目にチェックを入れて「一括実行」をクリックします。ポップアップウィンドウで:

  • ワークフローごとに変数を個別に入力します (またはデフォルト値を直接使用します)。
  • 同時に開く行数を制御するには、同時実行数 (1 ~ 10) を選択します。
  • 障害戦略の選択: 1 つの障害が他の障害を妨げるかどうか

ダイアログのティアダウンを実行する

どのエントリを入力しても、「実行」をクリックすると、同じ構造のダイアログ ボックスが表示されます。

パラメータ(変数)エリア

workflow.variables で各パラメータを自動表示します。

  • デフォルト値を事前入力します
  • 必須フィールドには赤いアスタリスクが付いています
  • 説明にカーソルを合わせると説明が表示されます
  • 列挙型はドロップダウン メニューを使用します
  • 配列/オブジェクト型は JSON を直接編集します

ドライランスイッチ

最初の実行時にチェックボックスをオンにすることを強くお勧めします。詳細については、上記のクイックスタートを参照してください。

トリガーソース(デバッグ)

デフォルトのマニュアル。デバッグ用に「時限トリガー」または「Webhook トリガー」をシミュレートしたい場合は、切り替えることができます。一部のステップの条件はこれに依存する場合があります。

回復スイッチ (Pro+)

ワークフローでrecovery.autoResumeOnRestartを宣言すると、ダイアログボックスに「この実行で自動継続を許可するかどうか」という追加の切り替えが表示されます。詳細を見る 自動再開

デバッグスイッチ (Pro+)

確認後、この実行はデバッグ モードに入ります。ブレークポイントの設定、シングルステップ実行、変数の表示、変数の変更が可能です。詳細を見る ブレークポイントのデバッグ

起動後の動作

「実行開始」をクリックした後:

  1. フロントエンドはすぐに実行レコード (ステータス PENDING) を作成し、ページは自動的に実行の詳細にジャンプします。
  2. 平台调度器拉起执行(通常 < 200ms 内从 PENDING 变 RUNNING)。
  3. ページは SSE 接続を確立し、各イベントがプッシュされて UI がリアルタイムで更新されます。
  4. キャンバス内の「実行中のステップ」が強調表示されます。完了したステップは緑色で強調表示され、失敗したステップは赤色で強調表示されます。

右側にライブ イベント ストリーム

実行の詳細ページの右側の列は、「ログ + イベント」の混合ストリームです。重要なイベントの種類:

  • execution.started / execution.finished — 実行の開始と終了
  • step.started / step.completed / step.failed / step.skipped — ステップのライフサイクル
  • step.log — コードステップの stdout / stderr
  • agent.message — エージェントによる中間ステートメント (group_chat で最も一般的)
  • agent.tool_call — エージェントがツールを呼び出す + パラメータ + 戻り値
  • artifact.emitted — プロダクトの制作(Markdown/Excel/Image/JSON)
  • breakpoint.hit — ブレークポイントのヒット
  • approval.requested / approval.granted / approval.denied

各イベントにはタイムスタンプ、レベル (デバッグ/情報/警告/エラー)、および属性ステップがあります。フィルター バーを使用すると、タイプ/レベルでフィルターできます。

途中でキャンセルする

実行の詳細ページの右上隅にある「キャンセル」ボタンを使用すると、実行中の実行をアクティブに停止できます。

  1. 最初にステータスが「CANCELING」に変わります。
  2. 現在実行中のステップは割り込み信号を受信します (コード ステップは SIGTERM を受信し、LLM ステップはアクティブに中止されます)。
  3. すべてのステップが停止すると、ステータスは CANCELLED に変わります。

一部の時間のかかる操作 (長いネットワーク タイムアウト) は、すぐに応答しない場合があります。サンドボックス レベルのハード タイムアウトが処理し、最大 5 分以内に確実に停止します。

実行後に結果を確認する方法

実行の詳細ページ

  • ガントチャート — 全体的なタイムラインと各ステップにかかる時間
  • ステップリスト — シーケンシャルステップステータスの概要
  • ステップの詳細 — 入力/出力/イベントログ/ツールコール
  • 変数パネル — このステップが実行される前の、使用可能なすべての変数のスナップショット
  • 商品コラム — 生成されたファイル。クリックしてプレビューまたはダウンロードします

トークンとコスト

上部の概要バーには、合計所要時間、合計トークン (入出力)、合計コスト (USD) が表示されます。クリックして展開すると、各 LLM ステップの個別の消費量が表示されます。

共通操作

同じパラメータで再度実行します

実行の詳細ページの右上隅にある「再試行」ボタン - この実行の変数を使用して新しい実行をすぐに開始します。 2 つの結果を比較すると便利です。

途中の段差からまた走り出す

ステップの横にある [このステップから再試行] をクリックします。以前に完了したステップの結果は保持され、このステップからやり直すことができます。 「特定の手順ミスを修正した後、一からお金をかけたくない」場合に適しています。

エクスポート実行レポート

上部の「エクスポート」では、実行全体のメタデータ+ステップ詳細+成果物をJSONとしてエクスポートできます。後で見直したり、同僚と共有したりするのに適しています。

手動実行はどのような場合に使用する必要があり、他のトリガーを使用する必要があるのはどのような場合ですか?

  • マニュアル — 開発とデバッグ、1 回限りの要件、「今すぐ実行したい」
  • スケジュール実行 — 固定周波数自動トリガ
  • Webhook — 外部システムのイベント駆動型

次のステップ