Use Cases

Use Cases を使って、目的別に Vision Events をグループ化します。

ユースケース

Use Case は、共通の目的とカスタムメタデータ構造を共有する Vision Events のグループです。各イベントは必ず 1 つの Use Case に属します。同じ Use Case 内のイベントは通常、同じメタデータフィールドを共有するため、異なるソース間でデータを簡単にフィルタリングして比較できます。

1 つの Use Case を使う場合と、複数の Use Cases を使う場合

同じ Use Case にイベントを入れる 異なる場所、カメラ、またはデバイスから来ていても、類似したカスタムメタデータフィールドを共有している場合。たとえば、「Defect Detection」の Use Case では複数の工場からイベントを受信することがありますが、すべてのイベントには line_id, shift、および part_number.

別々の Use Cases を作成する メタデータ構造が根本的に異なる場合。たとえば：

• Assembly Line QA — を追跡 line_id, shift, part_number

• Warehouse Inventory — を追跡 通路, 棚, item_type

• Construction Site Safety — を追跡 zone, alert_type, contractor

Use Case を作成する

Agent 経由

その Roboflow Agent Vision Events を使って Workflow を構築すると、Use Cases を自動的に作成します。条件に合う既存の Use Case があればそれを選び、なければ説明されたユースケースに基づいて新しいものを作成します。Agent に直接、新しい Use Case の設定を依頼することもできます。

Dashboard で

1. 移動して Vision Events workspace の左サイドバーで

2. クリック + Create Use Case

3. Use Case の名前を入力します

REST API を使っても Use Cases を作成できます。詳しくは Use Cases をプログラムで管理する.

Use Cases を表示

Dashboard で

Vision Events ページには、すべての Use Cases の表が表示され、次の内容が示されます：

• Use Case 名

• イベント総数

• 最後のイベントのタイムスタンプ

• 使用中のイベントタイプ

API 経由

workspace 内のすべての Use Cases を取得します：

curl -X GET "https://api.roboflow.com/vision-events/use-cases" \
  -H "Authorization: Bearer YOUR_API_KEY"

を参照してください Vision Events API Reference 完全なレスポンス形式については。

Use Cases をプログラムで管理する

Dashboard に加えて、REST API を通じて Use Cases の作成、名前変更、アーカイブ、アーカイブ解除ができます。これらのエンドポイントには、 vision-events:manage スコープを持つ API キーが必要です（制限なしの workspace API keys はデフォルトでアクセスできます）。

Use Case を作成する

curl -X POST "https://api.roboflow.com/vision-events/use-cases" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "name": "assembly-line-qa" }'

Use Case の名前を変更する

curl -X PUT "https://api.roboflow.com/vision-events/use-cases/USE_CASE_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "name": "assembly-line-qa-v2" }'

Use Case をアーカイブまたはアーカイブ解除する

curl -X POST "https://api.roboflow.com/vision-events/use-cases/USE_CASE_ID/archive" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST "https://api.roboflow.com/vision-events/use-cases/USE_CASE_ID/unarchive" \
  -H "Authorization: Bearer YOUR_API_KEY"

Use Case をアーカイブする

Use Cases は、不要になったら Dashboard からアーカイブできます。アーカイブされた Use Cases とそのイベントには引き続きアクセスできますが、デフォルト表示では非表示になります。表示するには、 アーカイブされた Use Cases を表示 を Use Cases テーブルの下部でクリックしてください。

カスタムメタデータスキーマ

イベントが Use Case に送信された後、システムは観測されたフィールドと値の型に基づいてメタデータスキーマを推測します。Use Case の推定スキーマを取得して、どのキーと値の型が使用されているかを確認できます：

curl -X GET "https://api.roboflow.com/vision-events/custom-metadata-schema/assembly-line-qa" \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンスの例：

{
  "useCaseId": "assembly-line-qa",
  "fields": {
    "line_id": { "types": ["string"] },
    "shift": { "types": ["string"] },
    "temperature": { "types": ["number"] },
    "is_priority": { "types": ["boolean"] }
  }
}

を参照してください Vision Events API Reference 完全な詳細については。