> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ja/burokku/blocks/logic-and-branching/rate-limiter.md).

# レート制限

Workflow の分岐が実行される速度を制限します。

下流のワークフローステップの実行間に最小時間間隔を強制し、実行頻度を抑制し、接続されたステップが指定されたクールダウン期間より高い頻度で実行されないようにすることで過剰実行を防ぎます。

## このブロックの仕組み

このブロックは、連続する実行の間にクールダウン期間を強制することで、ワークフローブランチの実行レートを制限します。このブロックは次のことを行います:

1. クールダウン期間（秒単位）、 `depends_on` 参照、および `next_steps` を入力として受け取ります
2. 内部状態変数を使用して、最後の実行時刻を追跡します
3. 現在時刻を計算します:
   * 動画処理の場合: 動画メタデータ（フレーム番号と FPS）を使用して、以下のときに動画時間ベースのタイムスタンプを計算します `video_reference_image` が提供されている
   * その他のコンテキストの場合: システムクロック時刻（datetime.now()）を使用します
4. 前回の実行からの経過時間を `cooldown_seconds` しきい値と比較します
5. 十分な時間が経過している場合（経過時間 >= cooldown\_seconds）:
   * 最後の実行タイムスタンプを更新します
   * 指定された `next_steps` ブロックへの実行を継続し、下流の処理を許可します
6. 十分な時間が経過していない場合（経過時間 < cooldown\_seconds）:
   * 現在のワークフローブランチを終了し、クールダウン期間が切れるまで下流の実行を防ぎます
7. 次のステップへ継続するか、ブランチを終了するかのいずれかのフロー制御 निर्देश示を返します

このブロックはワークフロー実行全体を通じて実行状態を保持し、下流ステップが最後に実行された時刻を追跡します。 `depends_on` パラメータは依存関係を確立し、レートリミッターは依存ステップが完了した時点を監視して、クールダウン期間が経過したかどうかを判断します。動画ワークフローでは、このブロックは実時間ではなく動画時間ベースのタイムスタンプ（フレーム番号と FPS から計算）を使用でき、動画をリアルタイムより速く処理する場合に便利です。これにより、処理速度ではなく動画時間に対して正しくスロットリングが機能します。

## 要件

**重要な制限**: このレートリミッターは現在、動画処理のコンテキストでのみ機能します。HTTP サービス（Roboflow Hosted API、Dedicated Deployment、または self-hosted inference server）で動作するワークフローで使用した場合、各リクエストは独立しており、リクエスト間で実行状態が保持されないため、HTTP リクエストの処理に対してレート制限は効果を持ちません。

## 一般的な使用例

* **高コストな操作のスロットリング**: リソース集約型の下流操作の頻度を制限します（例: データアップロードを最大 5 秒ごとに実行し、それより高頻度で試行された場合はスキップする）。これによりシステム過負荷を防ぎ、従量課金の操作コストを削減します
* **通知スパムの防止**: 通知ブロックをスロットリングして、受信者が圧倒されないようにします（例: 検出が発生したときにメールアラートを 1 分に 1 回まで送信し、重複通知はスキップする）。これにより、アラートの意味と実用性が保たれます
* **API レート制限への準拠**: 外部 API 呼び出しやサービス連携に対してレート制限を適用します（例: 外部システムへの webhook 呼び出しを 1 秒に 1 回までに制限し、API クォータ超過を防ぐ）。これにより、外部サービスのレート制限に準拠できます
* **データベース書き込みの最適化**: データベースやデータ保存システムへの書き込み頻度を削減します（例: 検出結果を最大 10 秒ごとに記録し、更新を効率的にバッチ処理する）。これによりデータベース負荷を最小化し、システム全体のパフォーマンスを向上させます
* **動画処理の効率化**: 早送り処理によって多くのフレームが短時間で生成される動画ワークフローで、処理レートを制御します（例: 分析ステップを動画時間の 2 秒ごとに処理するようスロットリングし、リアルタイムより速く処理しても適切なタイミングを維持する）。正確なレート制限のために、動画時間ベースのスロットリングを使用します
* **リソース管理**: 高コストなモデル推論や処理ステップの実行頻度を制限することで計算資源を管理します（例: 高コストな分析を最大 3 秒に 1 回まで実行し、冗長な処理をスキップする）。処理速度とリソース制約のバランスを取ります

## 他のブロックへの接続

このブロックはワークフローの実行フローを制御し、次のように接続できます:

* **ワークフローステップの間に** 実行レートをスロットリングしたい場合、レートリミッターをソースステップ（ `depends_on`で参照される）とターゲットステップ（ `next_steps`で指定される）の間に配置して、実行間の最小時間間隔を強制します
* **通知ブロックの前に** （例: Email Notification、Slack Notification、Twilio SMS Notification）配置して、クールダウン期間より高い頻度でアラートが送信されないようにすることで通知スパムを防ぎ、アラートの有効性を保ちながら受信者が圧倒されるのを防ぎます
* **データ保存ブロックの前に** （例: Local File Sink、CSV Formatter、Roboflow Dataset Upload、Webhook Sink）配置して、書き込み操作をスロットリングし、保存やネットワークのオーバーヘッドを削減します。更新を効率的にバッチ処理し、過剰な書き込み操作を防ぎます
* **外部 API 連携の前に** （例: Webhook Sink）配置して、外部サービスのレート制限に準拠し、API 呼び出しが許可された頻度を超えないようにし、レート制限エラーを防ぎます
* **動画処理ワークフローでは** 早送り処理によってフレームが高速に生成される場合、 `video_reference_image` を使用して動画時間ベースのスロットリングを有効にし、動画をリアルタイムより速く処理しても正しく機能させ、動画再生時間に対して適切な実行タイミングを維持します
* **検出または分析ブロックの後に** （例: Object Detection、Classification、Line Counter）配置して、頻繁な検出やイベントによって引き起こされる下流処理をスロットリングし、毎フレーム検出が発生しても高コストな操作が頻繁に実行されないようにします

### 型識別子

ステップの `"type"` フィールドに次の識別子を使用してください: `roboflow_core/rate_limiter@v1` を使用して、このブロックをワークフローのステップとして追加します。

### プロパティ

| **名前**             | **型**   | **説明**                                                                                                                                                                                                                          | 参照 |
| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name`             | `str`   | このステップの一意の識別子を入力してください。                                                                                                                                                                                                         | ❌  |
| `cooldown_seconds` | `float` | next\_steps ブロックの連続実行の間に経過しなければならない最小秒数。レートリミッターは最後の実行タイムスタンプを追跡し、前回の実行から少なくともこの秒数が経過した場合にのみ実行を継続します。0.0 以上でなければなりません。動画ワークフローでは、video\_reference\_image が提供されている場合、このクールダウン期間はシステムクロック時刻ではなく動画時間（フレーム番号と FPS から計算）に基づいて強制されます。 | ❌  |

この **参照** 列は、 `ワークフロー` 実行時に利用可能な動的値でプロパティをパラメータ化できることを示します。 *Bindings* の詳細は参照してください。

### ランタイム互換性

`soft` - runtime `hosted_serverless`, `dedicated_deployment`; execution `remote` : クールダウン／レート制限タイマーはプロセスメモリに保存されます。ステートレスまたはマルチレプリカの HTTP ランタイムでリモートステップ実行を行う場合、各リクエストは新しいワーカーに割り当てられるため、クールダウンはスロットリングしません。クールダウンがドキュメントどおりに動作するのは、InferencePipeline 内でのローカルステップ実行のみです。

### 入力と出力のバインディング

利用可能な接続は、そのバインディング種別に依存します。Rate Limiter v1 が持つバインディング種別を確認してください。 `Rate Limiter` バージョン `v1` にあるものを確認してください。

<details>

<summary>入力と出力のバインディング</summary>

* 入力
  * `depends_on` ([*`*`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/wildcard.md)) : このレートリミッターブロックの直前にあるワークフローステップへの参照。これにより依存関係が確立され、レートリミッターはこのステップが完了した時点を監視して、前回の実行からクールダウン期間が経過したかどうかを判断します。depends\_on ステップは、その出力がレート制限された下流処理をトリガーする任意のワークフローブロックにできます。
  * `next_steps` (*ステップ*) : レート制限が許可された場合に実行するワークフローステップのリスト（つまり、前回の実行から十分な時間が経過している場合）。これらのステップは、クールダウン期間が経過した場合にのみ制御フローを受け取り、スロットリングされた下流処理を可能にします。クールダウン期間が経過していない場合、ブランチが終了するためこれらのステップは実行されません。各ステップセレクターは、レート制限が許可されたときに実行されるべきワークフロー内のブロックを参照します。
  * `video_reference_image` ([*`image`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)) : 動画時間ベースのタイムスタンプ生成に使用する動画フレーム画像へのオプション参照。提供された場合、レートリミッターはシステムクロック時刻ではなく動画メタデータ（フレーム番号と FPS）に基づいてタイムスタンプを計算します。これは、動画をリアルタイムより速く処理する場合に有用で、処理速度ではなく動画再生時間に対してレート制限が正しく機能するようにします。提供されない場合（None）、ブロックはシステムクロック時刻（datetime.now()）を使用します。動画処理ワークフローにのみ適用されます。
* 出力

</details>

<details>

<summary>JSON 定義例</summary>

```json
{
	    "name": "<ここにあなたの_step_nameを記入>",
	    "type": "roboflow_core/rate_limiter@v1",
	    "cooldown_seconds": 1.0,
	    "depends_on": "$steps.model",
	    "next_steps": [
	        "$steps.upload"
	    ],
	    "video_reference_image": "$inputs.image"
	}
```

</details>
