# Use Cases

## 使用例

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

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

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

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

* **Assembly Line QA** — を追跡 `line_id`, `shift`, `part_number`
* **Warehouse Inventory** — を追跡 `通路`, `棚`, `item_type`
* **Construction Site Safety** — を追跡 `zone`, `alert_type`, `請負業者`

### Use Case を作成する

#### Dashboard で

1. 移動する **Vision Events** workspace の左サイドバーにある
2. クリック **+ Create Use Case**
3. Use Case の名前を入力する

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

REST API でも Use Case を作成できます。詳細は [Use Cases をプログラムで管理する](#manage-use-cases-programmatically).

### Use Cases を表示する

#### Dashboard で

Vision Events ページには、すべての Use Case の表が表示され、以下が示されます:

* Use Case 名
* イベント総数
* 最後のイベントのタイムスタンプ
* 使用中のイベントタイプ

#### API 経由で

workspace 内のすべての Use Case を取得します:

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

以下を参照してください [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events) 完全なレスポンス形式について。

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

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

**Use Case を作成する**

```bash
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 の名前を変更する**

```bash
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 をアーカイブまたはアーカイブ解除する**

```bash
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 Case は、不要になったときに Dashboard からアーカイブできます。アーカイブされた Use Case とそのイベントは引き続きアクセス可能ですが、デフォルト表示では非表示になります。 **View archived use cases** を Use Cases テーブルの下部でクリックすると表示できます。\ <br>

<figure><img src="/files/c5d7988abd1d7c71443ac02f1ecf91d7ba5a8877" alt=""><figcaption></figcaption></figure>

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

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

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

**レスポンス例:**

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

以下を参照してください [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events) 詳細は


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/roboflow/roboflow-jp/deploy/vision-events/use-cases.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.