> 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 つの方法。 ## イベントを送信 Vision Events は、Workflow ブロック、REST API、またはエッジデバイスのバックアップを使って送信できます。 * [ワークフローブロック](#workflow-block) - Workflows のユーザーは、公式の Roboflow ブロックを使うのが最も簡単でしょう * [REST API](#rest-api) - Workflows の外でモデルをデプロイするユーザーは、REST API を使用できます * [エッジデバイスバックアップ](#edge-device-backup) - Roboflow Edge デバイスをデプロイするユーザーは、デバイス上のローカルイベントストアから自動バックアップを設定するのが最も便利です ### ワークフローブロック ほとんどのユーザーに推奨される方法です。次を追加してください **Vision Event** ブロックを任意の Roboflow Workflow に追加すると、コード不要で推論結果からイベントを自動作成できます。 {% hint style="info" %} その [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) が設定を代行できます。Agent にモデルを実行する Workflow の作成を依頼すると、Vision Events ブロックが自動的に追加され、適切な [ユースケース](/deployment/ja/to/vision-events/use-cases.md). {% endhint %} #### 設定 {% stepper %} {% step %} **ワークフローエディタを開く** 次に移動してください **Workflows** でワークスペース内の対象ワークフローを開きます。 {% endstep %} {% step %} **Vision Event ブロックを追加** ブロックカタログで「Vision Event」を検索し、ワークフローに追加します。 {% endstep %} {% step %} **入力を接続** 画像入力とモデル予測の出力を Vision Event ブロックに接続します。 {% endstep %} {% step %} **ユースケースを設定** ユースケース名（`useCaseId`）を設定します。上流のブロックからカスタムメタデータをマッピングすることもできます。ユースケースを選択したら、ドロップダウンの下にある「Vision Events で開く」をクリックして、新しいタブでそのユースケースのイベントページへ移動します。 {% endstep %} {% step %} **ワークフローをデプロイ** ワークフローをデプロイまたは更新します。ワークフローが実行されるたびに、イベントは自動的に作成されます。 {% endstep %} {% endstepper %} {% hint style="info" %} Workflow ブロックは、画像のアップロードとイベント作成を1つのステップで処理します。添付できるのは画像のみです。動画クリップを添付するには、次を使用してください [REST API](#attach-a-video) または [エッジデバイスバックアップ](#edge-device-backup). {% endhint %} ### REST API Workflows を使わないカスタム統合やパイプラインでは、REST API から直接イベントを送信できます。完全なリクエスト/レスポンスのスキーマについては、次を参照してください [Vision Events API リファレンス](/deployment/ja/to/vision-events.md#http-api). #### 認証 すべての書き込みエンドポイントには、次のスコープを持つ API キーが必要です `visionEvents.write` または `device.update` 。API キーを Bearer トークンとして渡します: ``` Authorization: Bearer YOUR_API_KEY ``` #### エンドツーエンドの例: 画像をアップロード + イベントを作成 {% hint style="warning" %} イベントを送信する前に、ユースケースを作成する必要があります。 `useCaseId` が存在しないイベントは拒否されます。 {% endhint %} API でイベントを送信する場合は、最初に画像をアップロードし、その後、アップロードした画像を参照するイベントを作成します。 **ステップ1: 画像をアップロード** ```bash curl -X POST "https://api.roboflow.com/vision-events/upload" \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "file=@inspection_photo.jpg" ``` **レスポンス:** ```json { "success": true, "sourceId": "abc123def456", "url": "https://storage.googleapis.com/your-workspace/abc123def456/original.jpg" } ``` **ステップ2: アップロードした画像を参照してイベントを作成** ```bash curl -X POST "https://api.roboflow.com/vision-events" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "eventType": "quality_check", "useCaseId": "assembly-line-qa", "timestamp": "2026-03-30T14:30:00.000Z", "deviceId": "factory-cam-01", "streamId": "line-3", "images": [ { "sourceId": "abc123def456", "objectDetections": [ { "class": "defect", "x": 320, "y": 240, "width": 50, "height": 40, "confidence": 0.95 } ] } ], "eventData": { "result": "fail" }, "customMetadata": { "line_id": "line-3", "shift": "morning", "part_number": "PN-4421" } }' ``` **レスポンス:** ```json { "eventId": "evt-789ghi", "created": true } ``` #### 動画を添付 動画クリップは最大3 GB まで扱えるため、フォームアップロードではなく署名付きアップロードを使用します。アップロードを準備して `videoId`, `を取得します。` ファイルを返された URL に PUT し、その後 `videoId` イベントの `videos` 配列に追加します: ```json "videos": [ { "sourceId": "Kq4vX8mNp2RtY6wZ1bCd", "label": "line-3 camera" } ] ``` 次を参照してください [Vision Event の動画をアップロード](/deployment/ja/to/vision-events/upload-a-vision-event-video.md) 各手順について。 #### イベントを一括作成 batch エンドポイントを使用して、1回のリクエストで最大100件のイベントを送信できます: ```bash curl -X POST "https://api.roboflow.com/vision-events/batch" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "events": [ { "eventType": "quality_check", "useCaseId": "alksjdflaalsf32", "eventData": { "result": "pass" }, "customMetadata": { "line_id": "line-1" } }, { "eventType": "quality_check", "useCaseId": "alksjdflaalsf32", "eventData": { "result": "fail" }, "customMetadata": { "line_id": "line-2" } } ] }' ``` {% hint style="info" %} バッチリクエストごとに最大100件のイベントです。 {% endhint %} ### エッジデバイスバックアップ 接続が断続的になる可能性があるエンタープライズ導入では、エッジデバイスがイベントをローカルに保存し、接続が復旧すると Roboflow に同期します。 {% hint style="info" %} エッジデバイスバックアップには Deployment Manager が必要です。 [Deployment Manager のドキュメント](/deployment/ja/self-hosted/enterprise/deployment-manager.md) を参照してセットアップ手順を確認してください。 {% endhint %} Vision Events バックアップを有効にするには: 1. 開く **Deployment Manager** をワークスペース内で 2. 設定するデバイスを選択します 3. 有効にする **Vision Events バックアップ** デバイスの [イベントストア](/deployment/ja/self-hosted/enterprise/deployment-manager/services/event-store.md) 設定 4. イベントはデバイス上のローカルイベントストアに書き込まれます 5. デバイスが再接続すると、イベントは自動的に Roboflow に同期されます 同期が完了すると、イベントは Vision Events ダッシュボードに表示されます。 「Backup Mode」が「Records and Files」の場合、デバイス上のイベントに添付された動画クリップもアップロードされるため、ダッシュボードで再生できます。MP4 と MOV のクリップがアップロードされ、イベントごとに最大4件まで対応します。その他の形式はデバイス上に残ります。アップロードに失敗したクリップは、再試行ごとにイベントの遅延が約1時間発生します。失敗が繰り返されると（既定では3回）、イベントはクリップなしで同期されます。 [ドラフトイベントと動画](/deployment/ja/self-hosted/enterprise/deployment-manager/services/event-store.md#draft-events-and-video) パイプラインがデバイス上でクリップを添付する方法について。