> 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/deployment/ja/to/vision-events/send-events.md).

# イベントを送信

デプロイしたモデルから Vision Event を送信する 3 つの方法。

## イベントを送信する

ワークフローブロック、HTTP API、またはエッジデバイスのバックアップを使って、Visionイベントを送信できます。

* [ワークフローブロック](#workflow-block)：モデルがワークフロー内で実行される場合に最も簡単な方法です。
* [HTTP API](#http-api)：ワークフロー外にデプロイするモデル向けです。
* [エッジデバイスのバックアップ](#edge-device-backup)：デバイスのローカルイベントストアからイベントをバックアップする、Roboflowエッジデバイス向けです。

### ワークフローブロック

ほとんどのユーザーに推奨される方法です。次の項目を追加します。 **Vision Event** ブロックを任意のRoboflow Workflowに追加すると、コードを記述しなくても推論結果からイベントを自動作成できます。

{% hint style="info" %}
この [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) が設定を代行します。モデルを実行するWorkflowの構築をAgentに依頼すると、Vision Eventsブロックが自動的に追加され、適切な [ユースケース](https://docs.roboflow.com/deployment/ja/to/vision-events/use-cases.md).
{% endhint %}

#### セットアップ

{% stepper %}
{% step %}
**Workflow Editorを開く**

移動先： **Workflows** ワークスペースで、イベントを追加するワークフローを開きます。
{% endstep %}

{% step %}
**Vision Event ブロックを追加する**

ブロックカタログで「Vision Event」を検索し、ワークフローに追加します。
{% endstep %}

{% step %}
**入力を接続する**

画像入力とモデルの予測出力を Vision Event ブロックに接続します。
{% endstep %}

{% step %}
**ユースケースを設定する**

ユースケース名（`useCaseId`）を設定します。上流のブロックからカスタムメタデータをマッピングすることもできます。ユースケースを選択したら、ドロップダウンの下にある「Open in Vision Events」をクリックすると、新しいタブでそのユースケースのイベントページが開きます。
{% endstep %}

{% step %}
**ワークフローをデプロイする**

ワークフローをデプロイまたは更新します。ワークフローの実行ごとにイベントが自動的に作成されます。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Workflowブロックは、画像のアップロードとイベントの作成を1つのステップで処理します。添付できるのは画像のみです。動画クリップを添付するには、 [HTTP API](#http-api) または [Edge Device Backup](#edge-device-backup).
{% endhint %}

### HTTP API

Workflow以外で実行されるコードからイベントを送信するには、HTTP APIを使用します。各エンドポイントのページには、フィールド、必要なスコープ、レスポンスが記載されています。

{% hint style="warning" %}
イベントを送信する前に、 [ユースケース](https://docs.roboflow.com/deployment/ja/to/vision-events/use-cases.md) を作成してください。イベントの `useCaseId` がワークスペースで有効なユースケースではない場合でも、保存されますが、レスポンスに警告が含まれます。
{% endhint %}

1. 各画像を次の方法でアップロードします。 [ビジョンイベント画像をアップロード](https://docs.roboflow.com/deployment/ja/to/vision-events/upload-a-vision-event-image.md#http-api)。レスポンスには `sourceId`.
2. 動画クリップを添付するには、各クリップを次の方法でアップロードします。 [ビジョンイベント動画をアップロード](https://docs.roboflow.com/deployment/ja/to/vision-events/upload-a-vision-event-video.md#http-api)。 `videoId` と、クリップをアップロードするための署名付き URL が取得できます。クリップのサイズは最大 3 GB です。
3. イベントを次の方法で作成します。 [Vision Event の作成](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md#http-api)。各画像の `sourceId` を `images[].sourceId` に、各 `videoId` を `をvideos[].sourceId`.

1 回のリクエストで最大 100 件のイベントを送信するには、次を使用します。 [Vision Events の一括作成](https://docs.roboflow.com/deployment/ja/to/vision-events/batch-create-vision-events.md#http-api)。デプロイ環境からクラウドへの経路がない場合は、次を使用します。 [Vision Event バンドルのアップロード](https://docs.roboflow.com/deployment/ja/to/vision-events/upload-a-vision-event-bundle.md#http-api).

### エッジデバイスのバックアップ

接続が断続的になる可能性があるエンタープライズ環境では、エッジデバイスがイベントをローカルに保存し、接続が回復すると Roboflow に同期します。

{% hint style="info" %}
エッジデバイスのバックアップには Deployment Manager が必要です。セットアップ手順については、 [Deployment Manager のドキュメント](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager.md) をご覧ください。
{% endhint %}

Vision Events のバックアップを有効にするには、次の手順に従います。

1. Workspace で Deployment Manager を開き、デバイスを選択します。
2. 「Configuration」タブで、 [Event Store](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/services/event-store.md) カードの「Configure」をクリックします。
3. 「Enable Vision Events Backup」をオンにし、Use Case が指定されていないイベントに使用する「Default Use Case」を選択して、「Backup Mode」を選びます。
4. ウィンドウ内の「Save Configuration」をクリックし、次に「Configuration」タブの「Save Configuration」をクリックします。デバイスはイベントをローカルの Event Store に書き込み、再接続後も含めて Roboflow に同期します。

同期が完了すると、イベントが Vision Events ダッシュボードに表示されます。

「Backup Mode」が「Records and Files」の場合、デバイス上のイベントに添付された動画クリップもアップロードされ、ダッシュボードで再生できるようになります。アップロードされるのは MP4 と MOV のクリップで、イベントごとに最大 4 件です。それ以外の形式はデバイス上に残ります。クリップのアップロードに失敗すると、再試行のたびにイベントの同期が約 1 時間遅れます。既定では 3 回、繰り返し失敗すると、クリップなしでイベントが同期されます。デバイス上のパイプラインがクリップを添付する方法については、 [ドラフトイベントと動画](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/services/event-store.md#draft-events-and-video) をご覧ください。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-dad946e36678b43e2fe868c8972b9b8853eb724f%2Fimage%20(455).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
