> For the complete documentation index, see [llms.txt](https://studio-docs.japan-ai.co.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio-docs.japan-ai.co.jp/shi-yang-zhi-xian/workflow-and-automation-specs.md).

# Workflow・自動実行の仕様・制限

Workflowは、利用者が画面から開始するほか、イベントやProject設定のタスクスケジューラで設定したスケジュールをきっかけに自動実行できます。自動実行では、下書きではなく公開版を使うこと、失敗後の処理を事前に設計することが重要です。

* イベントで起動する：[Workflowトリガーを設定する](/ruworkflowto/configure-workflow-triggers.md)
* スケジュールを設定する：[タスクスケジューラを設定する](/ruworkflowto/configure-task-scheduler.md)
* 制限・提供条件：[制限・提供条件の索引](/guan-li-yun-yong/limits-and-availability-index.md)

## この記事の範囲

本記事では、次の実行方法について、起動条件、実行される版、実行者・利用上限の扱い、再試行を説明します。

* **手動実行**：利用者が画面から「実行を開始」する。
* **Workflowトリガー**：Workflowの開始ノードで設定したイベントにより起動する。
* **タスクスケジューラ**：Project設定のタスクスケジューラに登録したスケジュールにより起動する。

表示項目や利用可否は、組織・Project・権限・機能設定によって異なります。

## 実行方式ごとの仕様

| 起動方法         | 起動条件                               | 実行される版                                                  | 実行者・利用上限の扱い                                              | 再試行                            |
| ------------ | ---------------------------------- | ------------------------------------------------------- | -------------------------------------------------------- | ------------------------------ |
| 手動実行         | 利用者が開始する                           | 編集画面でのテストは保存済みの編集内容を対象にできる。公開済みWorkflowを一覧等から実行する場合は公開版 | 操作した利用者のコンテキスト                                           | 入力を確認し、通常の実行画面から改めて実行する        |
| Workflowトリガー | Webhook、メール受信、データ変更、文字起こし完了などのイベント | **公開版**                                                 | イベント送信者ではなく、Workflowの公開・設定時の権限や接続設定に依存。請求・控除の詳細は構成により異なる | 失敗したイベント実行で「再実行」が表示される場合に利用できる |
| タスクスケジューラ    | 指定日時または繰り返し時刻                      | **公開版**                                                 | Project設定のタスクスケジューラと接続設定により実行可否が判定される                    | 同じ処理の自動再実行は確認できない。実行履歴の確認は別操作  |

> **下書きを保存しただけでは自動実行の内容は変わりません。** Workflowトリガーとタスクスケジューラで実行される対象は公開版です。変更後はテスト、確認、公開の順で進めてください。

### 手動実行

編集画面での実行は、入力、接続、出力、エラー処理を確認するために使います。ただし、外部送信やレコード更新を含むWorkflowでは、テストでも実データへ影響する場合があります。公開前後で入力項目、接続先、書き込み処理を確認してください。

### Workflowトリガー

Workflowトリガーは開始ノードに設定します。「Webhookトリガー」「Gmail: 新着メール」「Outlook: 新着メール」「Speech: 文字起こしの完了」など、表示されるイベントを起点にします。公開が有効化の条件であり、変更後も再公開するまで新しい下書きは使われません。詳細は[Workflowトリガーを設定する](/ruworkflowto/configure-workflow-triggers.md)を参照してください。

Webhookトリガーでは、次の値を定義できます。

| 画面項目        | 取得元           |
| ----------- | ------------- |
| 「クエリパラメータ」  | URLのクエリ文字列    |
| 「ヘッダーパラメータ」 | HTTPリクエストヘッダー |
| 「ボディパラメータ」  | HTTPリクエストボディ  |

Webhook URLは公開後に生成されます。「署名検証」「署名ヘッダー」「Webhookシークレット」を必要に応じて設定し、URLの漏えい・意図しない起動を防いでください。

### タスクスケジューラ

Project設定のタスクスケジューラでは、公開済みのWorkflowを指定日時または繰り返し時刻に実行するスケジュールを設定します。必要な接続の未設定、Workflowの無効化、Workflow内モデルの提供状態も実行可否に影響します。

Projectのタスクスケジューラでは実行日時、繰り返し、終了日を設定します。時刻は日本時間（JST）で設定され、タイムゾーンを選択する項目はありません。繰り返しには「繰り返さない」「1時間ごと」「毎日」「平日」「1週間ごと」「1ヶ月ごと」「カスタム」があります。「カスタム」では、10・15・20・30分、または1・2・3・4・6・8・12・24時間の間隔を選択します。操作手順は[タスクスケジューラを設定する](/ruworkflowto/configure-task-scheduler.md)を参照してください。

Workflowの開始ノードで設定するイベントトリガーと、タスクスケジューラで設定するスケジュールは同じではありません。イベントトリガー（文字起こし完了を含む）の変更はWorkflow側で行います。スケジュールはProject設定のタスクスケジューラで設定し、実行結果はProjectのワークフローにある実行履歴で確認します。

## 上限・制限値

以下には、確認対象のコードで数値を検証できた値のみを掲載します。プラン別の回数・単価・同時実行数は含めません。

| 対象                           |                                                      上限・設定可能範囲 | 補足                                                                                              |
| ---------------------------- | -------------------------------------------------------------: | ----------------------------------------------------------------------------------------------- |
| Workflowのノード数                | Workflow管理ツール経由で保存する場合は最大500ノード。Studioの公開前検証・公開APIでは最大1,000ノード | 入口ごとに上限が異なる。上限を超えるとエラーになるため、利用する入口に表示される内容を確認する。                                                |
| Workflowの接続数                 | Workflow管理ツール経由で保存する場合は最大2,000接続。Studioの公開前検証・公開APIでは最大3,000接続 | ノード数とは別に検証される。                                                                                  |
| サブWorkflowの「タイムアウト（秒）」       |                                                      60〜1,800秒 | 初期値は300秒                                                                                        |
| サブWorkflowの「最大ネスト深度」         |                                                           1〜10 | 初期値は5                                                                                           |
| ノードの「失敗時の再試行」最大回数            |                                                          1〜10回 | 有効化時の初期値は3回                                                                                     |
| 公開済みAppのWorkflow実行入力：ファイル数   |                                                    1入力あたり最大10件 | 定義側の設定が10件未満の場合はその値を適用し、10件を超える指定は受け付けない。タスクスケジューラで設定するWorkflowに同じ上限が適用されるかは、各入力の設定と画面の表示で確認する。 |
| タスクスケジューラのWorkflow入力：ファイルサイズ |                                                    定義側の入力設定に従う | ファイル形式・サイズの上限は、各入力の設定値で検証される。                                                                   |
| カスタムの「繰り返し間隔」（分）             |                                                   10、15、20、30分 | 選択肢                                                                                             |
| カスタムの「繰り返し間隔」（時間）            |                                            1、2、3、4、6、8、12、24時間 | 選択肢                                                                                             |

上限まで設定できても、外部API、モデル、書き込み先、実行時間の制約により安定するとは限りません。小さな構成から始め、実行履歴で所要時間と消費量を確認してください。

## 再試行と再実行

「失敗時の再試行」はWorkflow内の対応ノードの設定です。「再実行」は、実行ログに残った失敗したWorkflow実行を、保存済みの入力で改めて開始する操作です。

| 操作         | 対象                               | 注意点                                                 |
| ---------- | -------------------------------- | --------------------------------------------------- |
| 「失敗時の再試行」  | Workflow内のノード                    | 回数を増やすほどプロバイダー呼び出しとコストが増える                          |
| 実行ログの「再実行」 | 失敗したWorkflow全体                   | 保存済み入力で実行するため、書き込み済みの処理があると重複する可能性がある               |
| 「実行」       | Project設定のタスクスケジューラにある有効な日時実行タスク | スケジュールを待たずに起動する操作であり、自動失敗再試行ではない。Webhookタスクでは利用できない |

「失敗した実行を再実行」する前に、対象レコード、外部送信、通知がすでに完了していないかを確認してください。カスタムオブジェクト等への書き込みが失敗表示の前に完了している場合、再実行でデータが重複する可能性があります。

## よくある誤解

### 下書きを保存すれば自動実行にも反映される

反映されません。Workflowトリガーとタスクスケジューラには公開版が使われます。変更後は公開が必要です。

### タスクスケジューラとWorkflowのイベントトリガーは同じ

異なります。タスクスケジューラはProject設定のスケジュールにより起動し、Workflowのイベントトリガーは開始ノードで設定したイベントにより起動します。文字起こし完了を含むイベントの設定はWorkflow側で行います。

### 失敗したら必ず自動で再実行される

必ずしもそうではありません。ノード単位の「失敗時の再試行」は明示的に設定します。タスクスケジューラによる実行の失敗を同じ処理で自動再実行する仕様は、ここで確認した範囲にはありません。

### 「再実行」なら安全に一回だけ処理できる

保証されません。保存済み入力で全体をやり直すため、外部送信・書き込みが完了済みなら重複する可能性があります。外部システム側の重複防止キーや処理済みフラグを設計してください。

## 確認できない場合

次の事項は、画面または確認対象コードだけでは一律に確定できません。

* 契約・プランごとの実行回数、クレジット単価、同時実行数、保持期間
* 実行方式ごとの最終的な請求額
* 外部サービス側の再送、タイムアウト、レート制限
* 組織の機能設定・権限・Project設定による表示可否

Projectのワークフローにある実行履歴で、実行ID、開始時刻、エラー詳細、入力、実行者を確認してください。続いて、Workflowの公開・無効化状態、Project設定のタスクスケジューラ、月間クレジット上限を管理者に確認します。契約・提供条件は[制限・提供条件の索引](/guan-li-yun-yong/limits-and-availability-index.md)を参照してください。

## 次に読む記事

* [Workflowトリガーを設定する](/ruworkflowto/configure-workflow-triggers.md)
* [タスクスケジューラを設定する](/ruworkflowto/configure-task-scheduler.md)
* [制限・提供条件の索引](/guan-li-yun-yong/limits-and-availability-index.md)
