Vision Events

本番環境で、デプロイ済みのコンピュータビジョンモデルが何を見ているかを記録、検索、分析します。

概要

全体概要

Vision Eventsは、Roboflowのデータストアで、デプロイしたコンピュータビジョンモデルからの視覚情報とともに、欠陥の検出や在庫数のカウントなどの重要なイベントを記録できます。これにより、本番環境であなたのビジョンシステムが観測したすべての履歴を検索・絞り込み可能な形で保存できます。

Vision Eventとは？

Vision Eventは、モデルが画像を処理したときに作成されるタイムスタンプ付きの記録です。各イベントでは、必要に応じて次の情報を取得できます：

画像: 処理された元画像と、それに関連付けられた出力画像
予測: モデルが返すオブジェクト検出、分類、インスタンスセグメンテーション、キーポイント
ソースメタデータ: どのデバイス、ストリーム、またはワークフローがイベントを生成したか
カスタムメタデータ: ドメイン用に定義するキーと値のペア（例： 行番号, シフト, 部品番号)

プログラムからのアクセスについては、次を参照してください： Vision Events API リファレンス.

主要概念

ユースケース

1つの ユースケース は、共通の目的とカスタムメタデータ構造を共有するイベントをグループ化します。同じユースケース内のイベントは通常、同様のメタデータフィールドを送信するため、一貫した方法でフィルタリングやクエリを行えます。

たとえば、「欠陥検出」ユースケースには常に line_id, シフト、および 部品番号 が含まれる場合があります。たとえイベントが複数の工場やカメラ設置場所から来たものであっても同様です。メタデータ構造が根本的に異なる場合は、別々のユースケースを作成してください（例：「PPE遵守」では ゾーン および アラート種別 を追跡します）。

このセクションでは

イベントを送信 - Workflowブロック、REST API、またはエッジデバイスのバックアップからイベントを送信します。
イベントをクエリ - ダッシュボードでイベントを絞り込み、Agentに自然言語で尋ねるか、API経由でクエリします。
学習用の画像を追加 - キャプチャしたイベント画像をプロジェクトに移して、モデルを学習させます。
オペレーターのフィードバック - チームメンバーがイベントを正しい、誤り、または判断不能としてマークできるようにします。
要約レポート - ユースケースの定期要約をチームにメール送信します。
イベントを削除 - もう不要なイベントをユースケースから削除します。

HTTP API

Vision Events APIを使うと、コンピュータビジョンのデプロイから構造化されたイベントを記録し、その後にクエリや分析を行えます。イベントには、画像、検出アノテーション、カスタムメタデータ、品質チェック、在庫数、安全アラートなどの種類固有データを含めることができます。

Vision Events API でできること：

認証

すべてのVision Eventsエンドポイントは、Roboflow APIキーを使用したBearerトークン認証を使います：

Authorization: Bearer YOUR_API_KEY

Vision Eventsエンドポイントには、特定のスコープ付きAPIキー権限が必要です：

読み取り操作 (クエリ、一覧表示、スキーマ取得)： vision-events:read または device:read
書き込み操作 (作成、一括作成、アップロード)： vision-events:write または device:update

ユースケース

各Vision Eventはユースケースに関連付けられます。ユースケースの作成と管理方法については、次を参照してください：ユースケースのドキュメント.

また、既存のユースケースを一覧表示できます API経由でイベントを記録したもの。

イベントタイプ

APIは5種類のイベントタイプをサポートしており、それぞれに独自の eventData スキーマがあります：

イベントタイプ

説明

quality_check

QAと検査の結果

inventory_count

在庫の測定値

safety_alert

安全上のインシデントとアラート

custom

自由形式のイベントデータ

operator_feedback

モデル予測に対する人によるフィードバック

データ保持

イベントは、設定可能なルックバック期間（デフォルト：14日）保持されます。 lookbackDays その値はクエリ応答で返されるため、ワークスペースの実際の保持期間を把握できます。

Python SDK

Roboflow Python SDKは、次の上でVision Eventを扱うためのメソッドを提供します： Workspace オブジェクト。イベントの作成、フィルターとページネーション付きのクエリ、画像のアップロード、ユースケース管理ができます。

イベントスキーマ、フィルタリングオプション、レスポンス形式の詳細については、次を参照してください： Vision Events REST API ドキュメント.

クイックスタート

import roboflow

roboflow.login()

rf = roboflow.Roboflow()
ws = rf.workspace()

# ユースケースを作成
result = ws.create_vision_event_use_case("manufacturing-qa")
use_case_id = result["id"]

# 画像をアップロード
img = ws.upload_vision_event_image("photo.jpg")

# アップロードした画像でイベントを作成
ws.write_vision_event({
    "eventId": "c3d4e5f6-a1b2-4c3d-8e5f-6a7b8c9d0e1f",
    "eventType": "quality_check",
    "useCaseId": use_case_id,
    "timestamp": "2024-01-15T10:30:00Z",
    "images": [{"sourceId": img["sourceId"]}],
    "eventData": {"result": "pass"},
})

# イベントをクエリ
for page in ws.query_all_vision_events(use_case_id):
    for evt in page:
        print(evt["eventId"], evt["eventType"])