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

# Use Cases

## Use Cases

एक Use Case ऐसे Vision Events को समूहित करता है जिनका उद्देश्य समान होता है और custom metadata structure भी समान होता है। हर event ठीक एक Use Case से संबंधित होता है। एक ही Use Case के events आमतौर पर एक ही metadata fields साझा करते हैं, जिससे अलग-अलग sources के बीच data को filter और compare करना आसान हो जाता है।

### एक बनाम कई Use Cases कब उपयोग करें

**events को एक ही Use Case में रखें** जब उनके custom metadata fields समान हों, भले ही वे अलग-अलग locations, cameras, या devices से आए हों। उदाहरण के लिए, "Defect Detection" Use Case को कई factories से events मिल सकते हैं, लेकिन सभी events में शामिल होंगे `line_id`, `shift`और `part_number`.

**अलग-अलग Use Cases बनाएं** जब metadata structure मूल रूप से अलग हो। उदाहरण के लिए:

* **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-hi/agents/roboflow-agent.md) Vision Events के साथ एक Workflow बनाता है, तो logging से पहले वह आपसे Use Case की पुष्टि करता है। किसी नए Workflow के लिए यह डिफ़ॉल्ट रूप से एक नया Use Case बनाने का विकल्प चुनता है, और केवल तब किसी मौजूदा Use Case का पुनः उपयोग करता है जब वह स्पष्ट रूप से वही उद्देश्य साझा करता हो या आप उसे नाम दें। आप Agent से सीधे नया Use Case सेट अप करने के लिए भी कह सकते हैं, या logging से बाहर निकल सकते हैं।

#### Dashboard में

1. पर जाएँ **Vision Events** अपने workspace के left sidebar में
2. क्लिक करें **+ Create Use Case**
3. Use Case के लिए एक नाम दर्ज करें

<figure><img src="/files/661a2b3e3d2f79380027575950a03e51f818f66f" 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 का नाम
* कुल event संख्या
* Last event timestamp
* उपयोग में event types

#### 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) पूरे response format के लिए।

### Use Cases को प्रोग्रामेटिक रूप से प्रबंधित करें

Dashboard के अलावा, आप REST API के माध्यम से Use Cases बना, rename, archive, और unarchive भी कर सकते हैं। इन endpoints के लिए एक API key आवश्यक है जिसमें `vision-events:manage` scope हो (unrestricted workspace API keys को default रूप से access मिलता है)।

**एक 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 को archive या unarchive करें**

```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 को archive करें

जब Use Cases की आवश्यकता न रहे, तो उन्हें dashboard से archive किया जा सकता है। Archived Use Cases और उनके events उपलब्ध रहते हैं, लेकिन default view से छिपे रहते हैं। उन्हें देखने के लिए क्लिक करें **Archived use cases देखें** Use Cases तालिका के नीचे\ <br>

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

### Custom Metadata Schema

Events को Use Case में भेजे जाने के बाद, system देखे गए fields और value types के आधार पर metadata schema का अनुमान लगाता है। आप किसी Use Case के लिए अनुमानित schema प्राप्त कर सकते हैं ताकि समझ सकें कि कौन-से keys और value types उपयोग में हैं:

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

**उदाहरण response:**

```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) पूरी जानकारी के लिए।