> 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 Events は、Workflow ブロック、REST API、またはエッジデバイスのバックアップを使用して送信できます。

* [Workflow ブロック](#workflow-block) - Workflows のユーザーは、おそらく公式の Roboflow ブロックを使うのが最も簡単でしょう
* [REST API](#rest-api) - Workflows の外でモデルをデプロイするユーザーは、当社の REST API を使用できます
* [エッジデバイスのバックアップ](#edge-device-backup) - Roboflow Edge デバイスをデプロイするユーザーは、デバイス上のローカルイベントストアから自動バックアップを設定するのが最も便利です

### Workflow ブロック

ほとんどのユーザーに推奨される方法です。次を追加します **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 %}
**Workflow エディタを開く**

次に移動: **Workflows** で、イベントを追加したい workflow を開きます。
{% endstep %}

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

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

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

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

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

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

{% step %}
**Workflow をデプロイ**

workflow をデプロイまたは更新します。workflow が実行されるたびにイベントが自動作成されます。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Workflow ブロックは、画像のアップロードとイベント作成を 1 ステップで処理します。
{% 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
}
```

#### イベントを一括作成

バッチエンドポイントを使用して、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" %}
Edge Device Backup には Deployment Manager が必要です。次を参照してください: [Deployment Manager のドキュメント](/deployment/ja/serufuhosuto/enterprise/deployment-manager.md) セットアップ手順について
{% endhint %}

Vision Events バックアップを有効にするには:

1. 開く **Deployment Manager** をワークスペース内で
2. 設定するデバイスを選択
3. 有効化 **Vision Events バックアップ** デバイスの [Event Store](/deployment/ja/serufuhosuto/enterprise/deployment-manager/services/event-store.md) 設定
4. イベントはデバイス上のローカルイベントストアに書き込まれます
5. デバイスが再接続すると、イベントは自動的に Roboflow に同期されます

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

<figure><img src="/files/55b18c419b69d13df612a86c6ce921b0be140eb4" alt="" width="375"><figcaption></figcaption></figure>