> 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/roboflow/roboflow-jp/deploy/vision-events/use-cases.md).

# Use Cases

## Use Cases

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 Case を作成する** メタデータ構造が根本的に異なるとき。たとえば:

* **Assembly Line QA** — を追跡 `line_id`, `shift`, `part_number`
* **Warehouse Inventory** — を追跡 `aisle`, `shelf`, `item_type`
* **Construction Site Safety** — を追跡 `zone`, `alert_type`, `contractor`

### Use Case を作成する

#### Agent 経由で

その [Roboflow Agent](/roboflow/roboflow-jp/agents/roboflow-agent.md) が Vision Events を使って Workflow を構築するとき、記録する前に Use Case をあなたに確認します。新しい Workflow では、デフォルトで新しい Use Case を作成し、既存のものを再利用するのは、同じ目的を明確に共有している場合か、あなたが名前を付けた場合のみです。Agent に直接新しい 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 Cases を作成できます。詳細は [Use Cases をプログラムで管理する](#manage-use-cases-programmatically).

### Use Cases を表示

#### Dashboard で

Vision Events ページには、すべての Use Cases の表が表示され、次の情報が示されます:

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

#### API 経由で

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

```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 Cases の作成、名前変更、アーカイブ、アーカイブ解除ができます。これらのエンドポイントには、 `vision-events:manage` スコープを持つ API key が必要です（制限なしの workspace API keys にはデフォルトでアクセス権があります）。

**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 Cases は、不要になったら dashboard からアーカイブできます。アーカイブ済みの Use Cases とそのイベントは引き続きアクセスできますが、デフォルトビューでは非表示になります。 **アーカイブ済みの 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) 詳細は