> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ja/workflow/workflow-execution.md).

# ワークフローの実行

本記事では、ワークフローの実行方法・プレビュー実行・トリガーの設定について説明します。

## 実行のトリガー

ワークフローは以下の 4 つの方法で起動できます。

| トリガー           | 説明                                |
| -------------- | --------------------------------- |
| 手動実行           | 画面上から即座にワークフローを起動します              |
| API トリガー       | HTTP リクエスト経由で外部システムからワークフローを起動します |
| スケジュール         | 定期スケジュールに従ってワークフローを自動実行します        |
| GitHub Webhook | GitHub のイベントを契機にワークフローを自動実行します    |

{% hint style="warning" %}
既定では、同じワークフローを複数回実行すると同時に走ります。 **APIアクセス** 、 **スケジュール** 、 **GitHub Webhook** では、トリガー設定で **並行して実行** と **前の実行をキャンセル** を選べます。
{% endhint %}

## 手動実行

ワークフローは一覧画面またはエディター画面から手動で起動できます。

**一覧画面から実行する**

ワークフロー一覧の各行の操作メニューから **実行（▶実行アイコン）** をクリックします。

{% hint style="info" %}
ワークフローにユーザー入力が設定されていない場合、確認画面が表示され、入力を行い、そのまま実行できます。
{% endhint %}

## プレビュー実行

プレビュー実行では、通常の実行と同様に実行履歴には記録されますが、一覧上で「プレビュー」ラベルが付き、本番実行と区別して確認できます。

また、プレビュー実行で生成されたアーティファクトは、「アーティファクト」一覧には表示されますが、ナレッジベースにはインデックスされません（検索の対象外になります）。

### ワークフロー全体をプレビュー実行する

1. エディター画面を開きます。
2. キャンバス右下のツールバーにある **プレビュー（プレビューアイコン）** をクリックします。
3. 実行ダイアログが開きます。ユーザー入力が設定されている場合、実行前に値を確認・変更できます。
4. **ワークフローを実行** をクリックして実行を開始します。

実行結果はインスペクターの **出力** タブで確認できます。

プレビュー実行中、対象のブロックを選択するとインスペクターのヘッダーに **実行中** バッジが表示されます。実行が完了するまで **詳細** タブの編集は一時的にロックされます（ **出力** タブと削除ボタンはこれまでどおり操作できます）。

### 特定のブロックまでプレビュー実行する

ブロックの左に表示されている **プレビュー（プレビューアイコン）** をクリックすることで、そのブロックまでの処理のみをプレビュー実行できます。部分的に動作を確認したいときに便利です。

<figure><img src="/files/wPmVkh3AcAYmImjfwml8" alt="特定ブロックまでのプレビューのスクリーンショット"><figcaption><p>特定ブロックまでのプレビュー</p></figcaption></figure>

## トリガーの設定

ワークフロー編集画面の右上にある **その他のアクション** から **トリガー** をクリックすると、自動実行のトリガーを設定できます。

<figure><img src="/files/w7EO94UcfYH1dt6qH5pk" alt="トリガー設定画面のスクリーンショット"><figcaption><p>トリガー設定画面</p></figcaption></figure>

### API アクセス

HTTP リクエストを送ることで、外部システムや CI/CD パイプラインからワークフローを起動できます。

<figure><img src="/files/ZQ6manoU2YbjXax9cRcA" alt="APIアクセスの設定のスクリーンショット"><figcaption><p>APIアクセスの設定</p></figcaption></figure>

1. **APIアクセス** のスイッチを有効にします。
2. **並行実行ポリシー** で、同じワークフローの前回の API 実行がまだ待機中または実行中のときに、新しいリクエストをどう扱うかを選びます。

| 選択肢        | 内容                                                    |
| ---------- | ----------------------------------------------------- |
| 並行して実行     | 新しい実行を開始し、前回の実行もそのまま続けます                              |
| 前の実行をキャンセル | 同じワークフローの API 実行で、待機中または実行中の古い実行をキャンセルしてから新しい実行を開始します |

3. 表示される **APIエンドポイント** の URL をコピーします。
4. `x-api-key` ヘッダーに API キーを含めた POST リクエストを送信します。

```http
POST {APIエンドポイント URL}
x-api-key: {APIキー}
Content-Type: application/json

{
  "フィールド名": "値"
}
```

{% hint style="info" %}
API キーの管理は **設定 > APIキー** から行えます。
{% endhint %}

### スケジュール

定期スケジュールに従ってワークフローを自動実行できます。

1. **スケジュール** のスイッチを有効にします。
2. **頻度** で **毎時** ・ **毎日** ・ **平日** ・ **毎週** ・ **カスタム** から選択します。
3. **実行する分** または **時刻** を設定し、必要に応じて **曜日** 、 **タイムゾーン** 、 **cron 式** を指定します。
4. スケジュールのプレビューと **次回の実行** を確認し、 **並行実行ポリシー** で前回のスケジュール実行がまだ待機中または実行中のときに新しい実行をどう扱うかを選びます。

| 選択肢        | 内容                                                 |
| ---------- | -------------------------------------------------- |
| 並行して実行     | 新しい実行を開始し、前回の実行もそのまま続けます                           |
| 前の実行をキャンセル | 同じワークフローの待機中または実行中の古いスケジュール実行をキャンセルしてから新しい実行を開始します |

5. **スケジュールを保存** をクリックします。

{% hint style="warning" %}
**カスタム** を使用する場合、スケジュールの実行間隔は少なくとも 15 分空ける必要があります。
{% endhint %}

{% hint style="info" %}
スケジュールでトリガーされる場合、ワークフローのユーザー入力にはデフォルト値が使用されます。
{% endhint %}

### GitHub Webhook

GitHub のイベントを契機にワークフローを自動実行できます。

{% hint style="warning" %}
GitHub Webhook を使用するには、事前にワークスペースに GitHub を連携している必要があります。 **設定** から GitHub 連携を行ってください。
{% endhint %}

<figure><img src="/files/7lbu3XcJyYJDgNvZefJy" alt="GitHub Webhook の設定のスクリーンショット"><figcaption><p>GitHub Webhook の設定</p></figcaption></figure>

1. **GitHub Webhook** のスイッチを有効にします。
2. **これらのイベントでトリガー** から、ワークフローを起動するイベントを選択します。

| イベント    | 内容                                     |
| ------- | -------------------------------------- |
| プッシュ    | コードがブランチにプッシュされたときにトリガーされます            |
| プルリクエスト | プルリクエストが開かれた、閉じられた、または更新されたときにトリガーされます |
| リリース    | 新しいリリースが公開されたときにトリガーされます               |

3. **並行実行ポリシー** で、同じ条件に一致する GitHub イベントの前回実行がまだ待機中または実行中のときに、新しいイベントをどう扱うかを選びます。

| 選択肢        | 内容                                                              |
| ---------- | --------------------------------------------------------------- |
| 並行して実行     | 新しい実行を開始し、前回の実行もそのまま続けます                                        |
| 前の実行をキャンセル | 同じワークフロー・同じブランチ・同じイベントに一致する待機中または実行中の古い実行をキャンセルしてから、新しい実行を開始します |

4. 必要に応じて **リポジトリ** から対象リポジトリを選択します。選択しない場合は、連携済みのすべてのリポジトリが対象になります。
5. 必要に応じて **ブランチ** にブランチパターンを入力します（例：`main`、`release/*`）。入力しない場合は、すべてのブランチが対象になります。

{% hint style="info" %}
GitHub によってトリガーされる場合、ワークフローのユーザー入力にはデフォルト値が使用されます。
{% endhint %}

## 実行中の操作

### 実行の停止

実行中または待機中のワークフローを手動で停止できます。

1. 実行詳細画面を開きます。
2. **停止** をクリックします。

停止したワークフローはステータスが **キャンセル済み** になります。後から再開することもできます。

{% hint style="info" %}
実行にタイムアウトはありません。処理が完了するまで自動的に停止しません。長時間の実行が予想される場合は、手動で停止操作を行ってください。
{% endhint %}

{% hint style="info" %}
**前の実行をキャンセル** を選んでいる場合は、新しい API リクエスト、スケジュール実行、GitHub イベントが届いたときに、古い実行が自動でキャンセルされることがあります。実行詳細のヘッダーには **新しいトリガーによりキャンセル** と表示されます。
{% endhint %}

### 実行の再開

停止（キャンセル済み）したワークフローを再開できます。

1. 実行詳細画面を開きます。
2. **再開** をクリックします。

### ここから編集して再実行

過去の実行結果を確認しながら、特定の AI エージェントブロックのプロンプトを書き換えて再実行できます。上流ブロックの出力はそのまま引き継がれるため、上流の処理をやり直す必要はありません。プロンプトの編集は今回の再実行にのみ適用され、ワークフローテンプレート自体は変更されません。

1. ワークフローの実行詳細画面を開きます。
2. グラフ上で再実行したい AI エージェントブロックをクリックして選択します。
3. インスペクター、またはグラフノードのホバーボタンから **ここから編集して再実行** をクリックします。
4. ダイアログでプロンプトを編集し、 **ワークフローを再実行** をクリックします。

新しい実行が作成され、上流ブロックの出力と成果物を引き継いだまま、編集したブロックから後ろが再実行されます。

{% hint style="info" %}
アーカイブ済みのワークフローの実行からは、ここから編集して再実行はできません。
{% endhint %}

### ブロックのレビュー

ブロックに承認フローが設定されている場合、そのブロックの実行完了後に **レビュー待ち** 状態になります。担当者がレビューするまで、ワークフローは次のブロックに進みません。

<figure><img src="/files/XtaNIYNkaERuZXMC70xq" alt="ブロックのレビューのスクリーンショット"><figcaption><p>ブロックのレビュー</p></figcaption></figure>

「レビュー」をクリックすると、出力確認画面が表示されます。

* **承認** をクリックすると、ワークフローが次のブロックに進みます。
* **変更を承認** をクリックすると、ブロックの出力内容を編集した上で承認できます。
* **却下** をクリックすると、ワークフローの実行が失敗として終了します。

## 実行ステータス

| ステータス   | 説明                                     |
| ------- | -------------------------------------- |
| 待機中     | 実行の開始を待っている状態                          |
| 実行中     | 処理が進行中の状態                              |
| レビュー待ち  | ブロックの承認を待っている状態                        |
| 完了      | すべてのブロックが正常に完了した状態                     |
| 失敗      | エラーが発生して処理が中断した状態                      |
| キャンセル済み | ユーザーが手動で停止した、または新しい一致条件のトリガーに置き換えられた状態 |
| スキップ済み  | 条件分岐ブロックなどにより実行から除外された状態               |

{% hint style="warning" %}
いずれかのブロックが失敗すると、その時点で後続のブロックは実行されず、ワークフロー全体が **失敗** として終了します。「ブロックが失敗しても後続の処理を続ける」オプションはありません。
{% endhint %}

{% hint style="info" %}
条件分岐でループを構成している場合、最大ループ回数を超えると強制的にエラーで終了します。最大ループ回数はブロックの設定で変更でき、未設定時は 3 回が使用されます。
{% endhint %}

## トラブルシューティング

### ユーザー入力のバリデーションエラー

| メッセージ                                                               | 原因                              | 対処方法                             |
| ------------------------------------------------------------------- | ------------------------------- | -------------------------------- |
| テキストフィールド「{label}」を空にすることはできません。値を入力してください。                         | 必須のテキストフィールドに値が入力されていない         | 該当フィールドに値を入力してから実行してください         |
| 数値フィールド「{label}」を空にすることはできません。値を入力してください。                           | 必須のテキストフィールドや数値フィールドに値が入力されていない | 該当フィールドに値を入力してから実行してください         |
| ファイル「{label}」が見つからないか、利用できなくなりました。ファイルを再度アップロードするか、別のファイルを選択してください。 | アップロード済みのファイルが削除されたか利用不可になった    | ファイルを再度アップロードするか、別のファイルを選択してください |

### 使用制限エラー

| 状況                       | 原因          | 対処方法                        |
| ------------------------ | ----------- | --------------------------- |
| 「使用制限に達しました」と表示されて実行できない | 組織の使用制限に達した | 管理者に連絡して、使用制限の引き上げを依頼してください |

### GitHub Webhook エラー

| 状況                           | 原因                        | 対処方法                       |
| ---------------------------- | ------------------------- | -------------------------- |
| GitHub Webhook のスイッチが有効にできない | ワークスペースに GitHub が連携されていない | **設定** から GitHub を連携してください |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.genesis.autify.com/features-ja/workflow/workflow-execution.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.