> 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/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md).

# Use Cases

Use Cases का उपयोग करके Vision Events को उद्देश्य के अनुसार समूहित करें।

## परिचय

एक यूज़ केस उन [विज़न इवेंट्स](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events.md) को समूहबद्ध करता है जिनका उद्देश्य और कस्टम मेटाडेटा संरचना समान होती है, और हर इवेंट ठीक एक यूज़ केस से संबंधित होता है। इवेंट्स को इस तरह व्यवस्थित करने से समान फ़ील्ड रिपोर्ट करने वाले कैमरों, डिवाइसों और स्थानों के डेटा को फ़िल्टर करना और उनकी तुलना करना आसान हो जाता है।

जिन इवेंट्स के कस्टम मेटाडेटा फ़ील्ड समान हों, उन्हें एक ही यूज़ केस में रखें, भले ही वे अलग-अलग स्थानों, कैमरों या डिवाइसों से आए हों। उदाहरण के लिए, "दोष पहचान" यूज़ केस को कई फ़ैक्ट्रियों से इवेंट्स मिल सकते हैं, जिन सभी में ये फ़ील्ड हों: `line_id`, `shift`, और `part_number`। मेटाडेटा संरचना अलग होने पर अलग यूज़ केस बनाएँ:

* असेंबली लाइन गुणवत्ता आश्वासन: `line_id`, `shift`, `part_number`
* वेयरहाउस इन्वेंटरी: `aisle`, `shelf`, `item_type`
* निर्माण स्थल सुरक्षा: `zone`, `alert_type`, `contractor`

इवेंट्स आने के बाद, Roboflow उनमें मौजूद फ़ील्ड और वैल्यू के प्रकारों से एक कस्टम मेटाडेटा स्कीमा निर्धारित करता है। इसे देखने के लिए, कॉल करें [कस्टम मेटाडेटा स्कीमा प्राप्त करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/get-custom-metadata-schema.md).

यह [Roboflow एजेंट](https://docs.roboflow.com/agents/roboflow-agent) विज़न इवेंट्स के साथ वर्कफ़्लो बनाते समय एक यूज़ केस बनाता है। अगर कोई मौजूदा यूज़ केस उपयुक्त हो, तो वह उसका दोबारा उपयोग करता है। आप उससे एक यूज़ केस सेट अप करने के लिए भी कह सकते हैं।

यूज़ केस को आर्काइव करने पर वह डिफ़ॉल्ट व्यू में दिखाई नहीं देता। उसके इवेंट्स सुरक्षित रहते हैं और आप उसे अनआर्काइव कर सकते हैं। आर्काइव किए गए यूज़ केस को भेजे गए इवेंट्स अब भी स्टोर होते हैं, लेकिन हर इवेंट के लिए एक चेतावनी लौटाई जाती है।

### इवेंट का मूल्य

यूज़ केस का आर्थिक मूल्य ट्रैक करने के लिए इवेंट्स को मौद्रिक मूल्य दें (उदाहरण के लिए, पकड़े गए हर दोष की लागत)। यूज़ केस पर डिफ़ॉल्ट मूल्य और मुद्रा सेट करें। जिन नए इवेंट्स के साथ उनका अपना मूल्य नहीं भेजा जाता, उन्हें डिफ़ॉल्ट मूल्य मिलता है; पहले से भेजे गए इवेंट्स अपना मूल्य बनाए रखते हैं।

इवेंट अपना मूल्य `valueBaseUnits` में भी भेज सकता है (देखें [विज़न इवेंट बनाएँ](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api))। मूल्य हमेशा यूज़ केस की मुद्रा में होता है। कुल मूल्य लगभग हर 5 मिनट में अपडेट होता है।

### चेकलिस्ट

चेकलिस्ट उन चरणों को ट्रैक करती है जिन्हें किसी स्टेशन पर एक यूनिट को पास करना होता है (उदाहरण के लिए, किसी बोर्ड पर चार स्क्रू)। हर चेकलिस्ट का एक नाम और आइटम की सूची होती है। एक यूज़ केस में अधिकतम 20 चेकलिस्ट हो सकती हैं, जिनमें से हर एक में अधिकतम 50 आइटम हो सकते हैं। Roboflow चेकलिस्ट की स्थिति आपके `quality_check` इवेंट्स से पढ़ता है। वह अलग से कोई स्थिति स्टोर नहीं करता।

हर यूनिट के लिए एक विंडो होती है। यूनिट के हर `customMetadata` इवेंट में ये कुंजियाँ भेजें: `quality_check` इवेंट के लिए:

* `checklistId`: चेकलिस्ट की ID।
* `checklistWindowId`: हर यूनिट के लिए एक ID (उदाहरण के लिए, उसका सीरियल नंबर)। उस यूनिट के हर इवेंट में एक ही ID इस्तेमाल होती है।
* `checklistRole`: `window_open`, `item`, या `window_close`.
* `checklistItemId`: वह आइटम जिसके लिए परिणाम है। इसे केवल `item` इवेंट पर भेजें।

किसी `item` इवेंट में, `eventData.result` को `pass` या `fail`पर सेट करें। हर इवेंट को अपना `eventId`दें। समान `eventId`, `timestamp`और `useCaseId` वाले इवेंट से पहले वाला इवेंट बदल जाता है।

"Require Order" चालू करें (API में`ordered` ) ताकि आइटम क्रम से पास हों। फिर कोई आइटम तभी पास माना जाएगा, जब उससे पहले के सभी आइटम पास हो चुके हों; और किसी आइटम के फ़ेल होने पर वह आइटम और उसके बाद के सभी आइटम साफ़ हो जाते हैं। इसे चालू न करने पर, आइटम किसी भी क्रम में पास हो सकते हैं और बाद में होने वाला फ़ेल किसी पास को साफ़ नहीं करता।

## Web App

अपने Workspace के बाएँ साइडबार में "Vision Events" खोलें और "+ Create Use Case" पर क्लिक करें।

<figure><img src="https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-e940058d52aa94761417871f65f91eaf3772b31e%2Fimage%20(456).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Use Cases तालिका में हर Use Case की इवेंट संख्या, आख़िरी इवेंट का समय, इवेंट के प्रकार और अब तक का कुल मूल्य दिखता है। Use Case के Overview में उसका मूल्य "Value Created" टाइल में दिखता है।

डिफ़ॉल्ट [इवेंट मूल्य](#event-value)सेट करने के लिए, Use Case का मेन्यू खोलें, "Update Settings" पर क्लिक करें और "Default Event Value" तथा "Currency" भरें।

चेकलिस्ट [जोड़ने](#checklists)के लिए, Use Case का मेन्यू खोलें, "Edit Checklists" पर क्लिक करें, फिर "Add Checklist" पर क्लिक करें। अपने बदलाव सहेजने के लिए "Save Checklists" पर क्लिक करें। हर यूनिट की प्रगति देखने के लिए, Use Case खोलें और "Checklists" टैब पर क्लिक करें। Connect Guide में आपकी चेकलिस्ट आईडी वाले नमूना चेकलिस्ट इवेंट दिए गए हैं।

आप डैशबोर्ड से किसी Use Case को आर्काइव कर सकते हैं। आर्काइव किए गए Use Case देखने के लिए, तालिका के नीचे "View archived use cases" पर क्लिक करें।

<figure><img src="https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-a19e941a3d1c11eebe09fc1426edc618aef53913%2FDashboard%20view%20for%20solution%20nine%20status.png?alt=media" alt=""><figcaption></figcaption></figure>

## HTTP API

अनियंत्रित Workspace API कुंजियों में डिफ़ॉल्ट रूप से `vision-events:manage` स्कोप होता है।

### Use Case बनाएँ

अपने Workspace में एक नया Use Case बनाएँ। Use Case, डिप्लॉयमेंट के संदर्भ के अनुसार विज़न इवेंट व्यवस्थित करने में मदद करते हैं (जैसे, "Manufacturing Line 1", "Warehouse Inventory")।

**ज़रूरी स्कोप:** `vision-events:manage`

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/use-cases" method="post" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

#### टिप्पणियाँ

* नए Use Case डिफ़ॉल्ट रूप से `active` स्थिति में बनाए जाते हैं।
* Use Case बनाने के बाद, आप उसके `id` को `useCaseId` के रूप में संदर्भित कर सकते हैं, जब [विज़न इवेंट बनाना](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api).

### यूज़ केस अपडेट करें

किसी मौजूदा यूज़ केस का नाम, स्थिति, डिफ़ॉल्ट इवेंट वैल्यू या चेकलिस्ट अपडेट करें। `checklists` भेजने पर यूज़ केस की सभी चेकलिस्ट बदल जाती हैं।

**ज़रूरी स्कोप:** `vision-events:manage`

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/use-cases/{useCaseId}" method="put" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

### यूज़ केस की सूची बनाएँ

अपने वर्कस्पेस में यूज़ केस की सूची बनाएँ। यूज़ केस बनाने और प्रबंधित करने का तरीका जानने के लिए देखें [यूज़ केस दस्तावेज़](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md).

**आवश्यक स्कोप:** `vision-events:read` या `device:read`

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/use-cases" method="get" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

### यूज़ केस को संग्रहित करें

किसी यूज़ केस की स्थिति को `inactive`पर सेट करके उसे संग्रहित करें। डिफ़ॉल्ट रूप से संग्रहित यूज़ केस सूचियों में छिपे रहते हैं। संग्रहित यूज़ केस को भेजे गए इवेंट फिर भी संग्रहीत होते हैं, लेकिन उनके साथ `entity_not_found` चेतावनी मिलती है।

**ज़रूरी स्कोप:** `vision-events:manage`

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/use-cases/{useCaseId}/archive" method="post" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

#### टिप्पणियाँ

* संग्रहित करना एक सॉफ्ट डिलीट है। यूज़ केस और उसके इवेंट सुरक्षित रहते हैं, लेकिन सक्रिय सूचियों में छिपे रहते हैं।
* संग्रहित यूज़ केस देखने के लिए, इस [यूज़ केस की सूची बनाएँ](#http-api) एंडपॉइंट का उपयोग करें और `status=inactive`.
* आप इस [यूज़ केस को संग्रह से निकालें](#http-api) एंडपॉइंट का उपयोग करके संग्रहित यूज़ केस को फिर से सक्रिय कर सकते हैं।

### यूज़ केस को संग्रह से निकालें

पहले से संग्रहित यूज़ केस की स्थिति को फिर से `active`.

**ज़रूरी स्कोप:** `vision-events:manage`

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/use-cases/{useCaseId}/unarchive" method="post" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

#### टिप्पणियाँ

* केवल वे यूज़ केस जिनकी स्थिति `inactive` है, संग्रह से निकाले जा सकते हैं।
* संग्रह से निकालने के बाद, यूज़ केस फिर से सक्रिय सूचियों में दिखाई देता है और नए इवेंट पर चेतावनी नहीं मिलती।

## Python SDK

हर विज़न इवेंट एक यूज़ केस से जुड़ा होता है। Python SDK में यूज़ केस बनाने, उनकी सूची देखने, उनका नाम बदलने, उन्हें संग्रहित करने और संग्रह से निकालने के तरीके उपलब्ध हैं।

### यूज़ केस की सूची बनाएँ

```python
import roboflow

roboflow.login()

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

result = ws.list_vision_event_use_cases()

for uc in result["useCases"]:
    print(uc["id"], uc["name"], uc.get("status"))
```

आप स्थिति के अनुसार फ़िल्टर कर सकते हैं:

```python
# केवल सक्रिय यूज़ केस की सूची बनाएँ
result = ws.list_vision_event_use_cases(status="active")
```

### Use Case बनाएँ

```python
result = ws.create_vision_event_use_case("manufacturing-qa")
use_case_id = result["id"]
print(f"Created use case: {use_case_id}")
```

### यूज़ केस का नाम बदलें

```python
ws.rename_vision_event_use_case("a1b3c8e1", "updated-name")
```

### यूज़ केस को संग्रहित करें

```python
ws.archive_vision_event_use_case("a1b3c8e1")
```

### यूज़ केस को संग्रह से निकालें

```python
ws.unarchive_vision_event_use_case("a1b3c8e1")
```

उपयोग के मामलों के प्रबंधन के बारे में अधिक जानकारी के लिए, देखें [REST API संदर्भ](#http-api).

## MCP सर्वर

अपने AI एजेंट को [MCP सर्वर](https://docs.roboflow.com/agents/mcp-server) से कनेक्ट करें, ताकि वह इन टूल का उपयोग करके उपयोग के मामलों का प्रबंधन कर सके:

<table data-search="false"><thead><tr><th width="290">टूल</th><th>विवरण</th></tr></thead><tbody><tr><td><code>vision_events_use_cases_list</code></td><td>वर्कस्पेस में विज़न इवेंट के उपयोग के मामलों की सूची दिखाएँ।</td></tr><tr><td><code>vision_events_use_case_create</code></td><td>विज़न इवेंट के उपयोग का नया मामला बनाएँ।</td></tr><tr><td><code>vision_events_use_case_rename</code></td><td>उपयोग के किसी मौजूदा मामले का नाम बदलें।</td></tr><tr><td><code>vision_events_use_case_archive</code></td><td>उपयोग के किसी मामले को संग्रहित करें।</td></tr><tr><td><code>vision_events_use_case_unarchive</code></td><td>पहले संग्रहित किए गए उपयोग के मामले को पुनर्स्थापित करें।</td></tr></tbody></table>
