> 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

## परिचय

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

## वेब ऐप

### उपयोग के मामले

एक यूज़ केस ऐसे विज़न इवेंट्स को समूहित करता है जो एक सामान्य उद्देश्य और कस्टम मेटाडेटा संरचना साझा करते हैं। हर इवेंट ठीक एक यूज़ केस से संबंधित होता है। एक ही यूज़ केस में मौजूद इवेंट्स आमतौर पर समान मेटाडेटा फ़ील्ड साझा करते हैं, जिससे अलग-अलग स्रोतों के डेटा को फ़िल्टर और तुलना करना आसान हो जाता है।

#### एक बनाम कई यूज़ केस कब उपयोग करें

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

**अलग-अलग यूज़ केस बनाएं** जब मेटाडेटा संरचना मूल रूप से अलग हो। उदाहरण के लिए:

* **असेंबली लाइन QA** - ट्रैक करता है `line_id`, `shift`, `part_number`
* **गोदाम इन्वेंट्री** - ट्रैक करता है `गलियारा`, `शेल्फ`, `item_type`
* **निर्माण स्थल सुरक्षा** - ट्रैक करता है `zone`, `alert_type`, `ठेकेदार`

#### यूज़ केस बनाएं

**एजेंट के माध्यम से**

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

**डैशबोर्ड में**

1. पर जाएँ **विज़न इवेंट्स** अपने वर्कस्पेस के बाएँ साइडबार में
2. क्लिक करें **+ यूज़ केस बनाएं**
3. यूज़ केस के लिए एक नाम दर्ज करें

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

आप REST API के माध्यम से भी यूज़ केस बना सकते हैं, देखें [प्रोग्रामेटिक रूप से यूज़ केस प्रबंधित करें](#manage-use-cases-programmatically).

#### यूज़ केस देखें

**डैशबोर्ड में**

विजन इवेंट्स पेज आपके सभी यूज़ केसों की एक तालिका दिखाता है, जिसमें शामिल हैं:

* यूज़ केस का नाम
* कुल इवेंट संख्या
* अंतिम इवेंट टाइमस्टैम्प
* उपयोग में इवेंट प्रकार

**API के माध्यम से**

अपने वर्कस्पेस में सभी यूज़ केस प्राप्त करें:

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

देखें [Vision Events API Reference](/deployment/hi/monitoring-and-analytics/vision-events.md#http-api) पूर्ण प्रतिक्रिया प्रारूप के लिए।

#### प्रोग्रामेटिक रूप से यूज़ केस प्रबंधित करें

डैशबोर्ड के अलावा, आप REST API के माध्यम से यूज़ केस बना, नाम बदल, आर्काइव और अनआर्काइव भी कर सकते हैं। इन एंडपॉइंट्स के लिए इस स्कोप वाला API key आवश्यक है: `vision-events:manage` (अप्रतिबंधित वर्कस्पेस API keys को डिफ़ॉल्ट रूप से पहुँच होती है)।

**यूज़ केस बनाएं**

```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" }'
```

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

```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" }'
```

**एक यूज़ केस को आर्काइव या अनआर्काइव करें**

```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"
```

#### एक यूज़ केस को आर्काइव करें

यूज़ केस जब अब आवश्यक न हों, तब उन्हें डैशबोर्ड से आर्काइव किया जा सकता है। आर्काइव किए गए यूज़ केस और उनके इवेंट्स उपलब्ध रहते हैं, लेकिन डिफ़ॉल्ट दृश्य में छिपे रहते हैं। उन्हें देखने के लिए क्लिक करें **आर्काइव किए गए यूज़ केस देखें** यूज़ केस तालिका के नीचे।\ <br>

<figure><img src="/files/0a03d438148dd59230f0d0ca4d8c24bbb2e9e451" alt=""><figcaption></figcaption></figure>

#### कस्टम मेटाडेटा स्कीमा

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

```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](/deployment/hi/monitoring-and-analytics/vision-events.md#http-api) पूर्ण विवरण के लिए।

## HTTP API

### यूज़ केस बनाएं

अपने वर्कस्पेस में एक नया यूज़ केस बनाएं। यूज़ केस आपको परिनियोजन संदर्भ (जैसे, "विनिर्माण लाइन 1", "गोदाम इन्वेंट्री") के अनुसार विज़न इवेंट्स को व्यवस्थित करने में मदद करते हैं।

**आवश्यक scope:** `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-2afefc06c784ca78eb7ec96a99bee48f8a2daaa5%2Fopenapi.yaml?alt=media)
{% endopenapi %}

#### अनुरोध बॉडी पैरामीटर

* **`name`** (string, आवश्यक): यूज़ केस के लिए एक नाम। यह 1 से 256 वर्णों के बीच होना चाहिए। नाम के आरंभ और अंत के रिक्त स्थान हटाए जाते हैं और यह वर्कस्पेस में अद्वितीय होना चाहिए।

#### उदाहरण अनुरोध

```bash
curl -X POST "https://api.roboflow.com/vision-events/use-cases" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "विनिर्माण लाइन 1"
  }'
```

#### उदाहरण प्रतिक्रिया

{% tabs %}
{% tab title="201" %}

```json
{
  "id": "a1b3c8e1",
  "name": "विनिर्माण लाइन 1"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "इस नाम का एक समाधान पहले से मौजूद है"
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "इस संसाधन के लिए अपर्याप्त अनुमतियाँ।"
}
```

{% endtab %}
{% endtabs %}

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

* नए यूज़ केस बनाए जाते हैं `सक्रिय` स्थिति के साथ डिफ़ॉल्ट रूप से।
* वर्कस्पेस के भीतर यूज़ केस नाम अद्वितीय होने चाहिए। किसी मौजूदा नाम वाले यूज़ केस को बनाने का प्रयास करने पर एक `400` त्रुटि.
* यूज़ केस बनाने के बाद, आप इसका `id` को `useCaseId` के रूप में [विजन इवेंट्स बनाते समय](/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api).

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

मौजूदा यूज़ केस के नाम या स्थिति को अपडेट करें।

**आवश्यक scope:** `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-2afefc06c784ca78eb7ec96a99bee48f8a2daaa5%2Fopenapi.yaml?alt=media)
{% endopenapi %}

#### पथ पैरामीटर

* **`useCaseId`** (string, आवश्यक): अपडेट किए जाने वाले यूज़ केस का ID।

#### अनुरोध बॉडी पैरामीटर

निम्नलिखित में से कम-से-कम एक फ़ील्ड प्रदान किया जाना चाहिए:

* **`name`** (string, वैकल्पिक): यूज़ केस के लिए नया नाम। यह 1 से 256 वर्णों के बीच होना चाहिए। यह वर्कस्पेस के भीतर अद्वितीय होना चाहिए।
* **`स्थिति`** (string, वैकल्पिक): नई स्थिति। इनमें से एक `सक्रिय` या `निष्क्रिय`.

#### उदाहरण अनुरोध

```bash
curl -X PUT "https://api.roboflow.com/vision-events/use-cases/a1b3c8e1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "विनिर्माण लाइन 2"
  }'
```

#### उदाहरण प्रतिक्रिया

{% tabs %}
{% tab title="200" %}

```json
{
  "id": "a1b3c8e1",
  "name": "विनिर्माण लाइन 2"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "इस नाम का एक समाधान पहले से मौजूद है"
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "समाधान नहीं मिला"
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "इस संसाधन के लिए अपर्याप्त अनुमतियाँ।"
}
```

{% endtab %}
{% endtabs %}

### Use Cases की सूची देखें

अपने वर्कस्पेस में रिकॉर्ड किए गए विज़न इवेंट्स वाले सभी यूज़ केस सूचीबद्ध करें। यूज़ केस बनाने और प्रबंधित करने के तरीके जानने के लिए देखें [Use Cases documentation](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md).

**आवश्यक scope:** `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-2afefc06c784ca78eb7ec96a99bee48f8a2daaa5%2Fopenapi.yaml?alt=media)
{% endopenapi %}

#### क्वेरी पैरामीटर

* **`स्थिति`** (string, वैकल्पिक): यूज़ केस स्थिति के आधार पर फ़िल्टर करें। इनमें से एक `सक्रिय` या `निष्क्रिय`। डिफ़ॉल्ट रूप से `सक्रिय`.

#### उदाहरण अनुरोध

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

#### उदाहरण प्रतिक्रिया

{% tabs %}
{% tab title="200" %}

```json
{
  "useCases": [
    {
      "id": "a1b3c8e1",
      "name": "विनिर्माण लाइन 1",
      "status": "active",
      "workspaceId": "my-workspace",
      "createdAt": "2024-01-10T08:00:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "id": "d4e5f6a7",
      "name": "गोदाम इन्वेंट्री",
      "status": "active",
      "workspaceId": "my-workspace",
      "createdAt": "2024-01-12T14:00:00.000Z",
      "updatedAt": "2024-01-15T09:00:00.000Z"
    }
  ],
  "lookbackDays": 14
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "इस संसाधन के लिए अपर्याप्त अनुमतियाँ।"
}
```

{% endtab %}
{% endtabs %}

### एक यूज़ केस को आर्काइव करें

इसकी स्थिति को सेट करके एक यूज़ केस को आर्काइव करें `निष्क्रिय`। आर्काइव किए गए यूज़ केस डिफ़ॉल्ट रूप से सूचियों से छिपे रहते हैं और नए इवेंट इनजेशन को अस्वीकार करेंगे।

**आवश्यक scope:** `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-2afefc06c784ca78eb7ec96a99bee48f8a2daaa5%2Fopenapi.yaml?alt=media)
{% endopenapi %}

#### पथ पैरामीटर

* **`useCaseId`** (string, आवश्यक): आर्काइव किए जाने वाले यूज़ केस का ID।

#### उदाहरण अनुरोध

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

#### उदाहरण प्रतिक्रिया

{% tabs %}
{% tab title="200" %}

```json
{
  "success": true
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "समाधान नहीं मिला"
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "इस संसाधन के लिए अपर्याप्त अनुमतियाँ।"
}
```

{% endtab %}
{% endtabs %}

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

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

### एक यूज़ केस को अनआर्काइव करें

पहले से आर्काइव किए गए यूज़ केस को उसकी स्थिति वापस सेट करके पुनर्स्थापित करें `सक्रिय`.

**आवश्यक scope:** `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-2afefc06c784ca78eb7ec96a99bee48f8a2daaa5%2Fopenapi.yaml?alt=media)
{% endopenapi %}

#### पथ पैरामीटर

* **`useCaseId`** (string, आवश्यक): अनआर्काइव किए जाने वाले यूज़ केस का ID।

#### उदाहरण अनुरोध

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

#### उदाहरण प्रतिक्रिया

{% tabs %}
{% tab title="200" %}

```json
{
  "success": true
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "समाधान आर्काइव नहीं है"
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "समाधान नहीं मिला"
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "इस संसाधन के लिए अपर्याप्त अनुमतियाँ।"
}
```

{% endtab %}
{% endtabs %}

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

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

## Python SDK

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

### Use Cases की सूची देखें

```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")
```

### यूज़ केस बनाएं

```python
result = ws.create_vision_event_use_case("manufacturing-qa")
use_case_id = result["id"]
print(f"बनाया गया यूज़ केस: {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>Workspace में vision event use cases की सूची देखें।</td></tr><tr><td><code>vision_events_use_case_create</code></td><td>एक नया vision event use case बनाएँ।</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>