> 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 ブロック

ほとんどのユーザーに推奨される方法です。追加する **ビジョンイベント** このブロックを任意の Roboflow Workflow に追加すると、コード不要で推論結果から自動的にイベントを作成できます。

{% hint style="info" %}
次の [Roboflow Agent](https://docs.roboflow.com/agents/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`）。上流のブロックからカスタムメタデータをマッピングすることもできます。ユースケースを選択したら、ドロップダウンの下にある「Open in 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).

#### 認証

すべての書き込みエンドポイントには、 `visionEvents.write` または `device.update` スコープを持つ API キーが必要です。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
}
```

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

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" %}
batch リクエストあたり最大 100 イベントです。
{% endhint %}

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

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

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

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

1. 開く **デプロイメント マネージャー** ワークスペースで
2. 設定するデバイスを選択します
3. 有効にする **Vision Events バックアップ** をデバイスの Event Store 設定で
4. イベントはデバイス上のローカルイベントストアに書き込まれます
5. デバイスが再接続すると、イベントは自動的に Roboflow に同期されます

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

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