> 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.md).

# Vision Events

## के बारे में

### अवलोकन

Vision Events एक Roboflow डेटास्टोर है, जो आपके डिप्लॉय किए गए कंप्यूटर विज़न मॉडल से दृश्य जानकारी के साथ-साथ महत्वपूर्ण घटनाएँ, जैसे दोष का पता लगना या इन्वेंटरी की गिनती, कैप्चर कर सकता है। इससे आपको प्रोडक्शन में आपका विज़न सिस्टम जो कुछ भी देखता है, उसका खोजने योग्य और फ़िल्टर करने योग्य इतिहास मिलता है।

### Vision Event क्या है?

Vision Event एक टाइमस्टैम्प किया हुआ रिकॉर्ड है, जो तब बनाया जाता है जब कोई मॉडल किसी छवि को प्रोसेस करता है। प्रत्येक इवेंट वैकल्पिक रूप से ये कैप्चर कर सकता है:

* **छवियाँ**: प्रोसेस की गई मूल छवियाँ और उनसे संबद्ध आउटपुट छवियाँ
* **पूर्वानुमान**: मॉडल द्वारा लौटाई गई ऑब्जेक्ट डिटेक्शन, वर्गीकरण, इंस्टेंस सेगमेंटेशन, या कीपॉइंट्स
* **स्रोत मेटाडेटा**: किस डिवाइस, स्ट्रीम, या वर्कफ़्लो ने इवेंट जनरेट किया
* **कस्टम मेटाडेटा**: आपके डोमेन के लिए आपके द्वारा परिभाषित की-वैल्यू जोड़े (उदा. `line_number`, `shift`, `part_number`)

प्रोग्रामेटिक पहुँच के लिए, देखें [Vision Events API संदर्भ](#http-api).

{% embed url="<https://www.youtube.com/watch?v=4HlYG1MacRk>" %}

### मुख्य अवधारणाएँ

#### Use Cases

एक **उपयोग केस** ऐसी घटनाओं को समूहित करता है जिनका एक समान उद्देश्य और कस्टम मेटाडेटा संरचना होती है। उसी उपयोग केस की घटनाएँ आम तौर पर समान मेटाडेटा फ़ील्ड भेजती हैं, ताकि आप उन्हें लगातार फ़िल्टर और क्वेरी कर सकें।

उदाहरण के लिए, एक "Defect Detection" उपयोग केस में हमेशा शामिल हो सकता है `line_id`, `shift`और `part_number` भले ही घटनाएँ कई फ़ैक्ट्रियों या कैमरा स्थानों से आती हों। जब मेटाडेटा संरचना मूल रूप से अलग हो, तब अलग उपयोग केस बनाएं (उदा. "PPE Compliance" ट्रैक करता है `zone` और `alert_type` के बजाय)।

### इस अनुभाग में

* [इवेंट भेजें](/deployment/hi/monitoring-and-analytics/vision-events/send-events.md) - Workflow ब्लॉक, REST API, या edge device backup से इवेंट भेजें।
* [प्रशिक्षण के लिए छवियाँ जोड़ें](/deployment/hi/monitoring-and-analytics/vision-events/add-images-for-training.md) - कैप्चर की गई इवेंट छवियों को मॉडल प्रशिक्षित करने के लिए किसी प्रोजेक्ट में ले जाएँ।
* [ऑपरेटर फ़ीडबैक](/deployment/hi/monitoring-and-analytics/vision-events/operator-feedback.md) - टीम सदस्यों को इवेंट को सही, गलत, या अनिर्णीत के रूप में चिह्नित करने दें।
* [सारांश रिपोर्ट](/deployment/hi/monitoring-and-analytics/vision-events/summary-reports.md) - अपनी टीम को किसी उपयोग केस का नियमित डाइजेस्ट ईमेल करें।
* [इवेंट हटाएँ](/deployment/hi/monitoring-and-analytics/vision-events/delete-events.md) - किसी उपयोग केस से वे इवेंट हटाएँ जिनकी अब आपको आवश्यकता नहीं है।

## HTTP API

Vision Events API आपको अपने कंप्यूटर विज़न डिप्लॉयमेंट से संरचित इवेंट रिकॉर्ड करने, फिर उन्हें क्वेरी और विश्लेषण करने की सुविधा देता है। इवेंट में छवियाँ, डिटेक्शन एनोटेशन, कस्टम मेटाडेटा, और गुणवत्ता जाँच, इन्वेंटरी गिनती, सुरक्षा अलर्ट, और अधिक के लिए प्रकार-विशिष्ट डेटा शामिल हो सकता है।

Vision Events API के साथ, आप यह कर सकते हैं:

* [एक विज़न इवेंट इमेज अपलोड करें](/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-image.md#http-api)
* [एक Vision Event बनाएं](/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api)
* [बैच में विज़न इवेंट बनाएं](/deployment/hi/monitoring-and-analytics/vision-events/batch-create-vision-events.md#http-api)
* [Query Vision Events](/deployment/hi/monitoring-and-analytics/vision-events/query-events.md#http-api)
* [उपयोग केस सूचीबद्ध करें](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#http-api)
* [कस्टम मेटाडेटा स्कीमा प्राप्त करें](/deployment/hi/monitoring-and-analytics/vision-events/get-custom-metadata-schema.md#http-api)

### प्रमाणीकरण

सभी Vision Events एंडपॉइंट आपके Roboflow API key के साथ Bearer token प्रमाणीकरण का उपयोग करते हैं:

```
Authorization: Bearer YOUR_API_KEY
```

Vision Events एंडपॉइंट के लिए विशिष्ट [scoped API key](https://docs.roboflow.com/reference/authentication/authentication/scoped-api-keys) अनुमतियाँ आवश्यक हैं:

* **पठन संचालन** (query, list, schema): `vision-events:read` या `device:read`
* **लेखन संचालन** (create, batch, upload): `vision-events:write` या `device:update`

### Use Cases

प्रत्येक विज़न इवेंट एक उपयोग केस से जुड़ा होता है। उपयोग केस बनाने और प्रबंधित करने का तरीका जानने के लिए देखें [Use Cases दस्तावेज़](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md).

आप यह भी कर सकते हैं [मौजूदा उपयोग केस सूचीबद्ध करें](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#http-api) जिनमें API के माध्यम से रिकॉर्ड किए गए इवेंट हैं।

### इवेंट प्रकार

API पाँच इवेंट प्रकारों का समर्थन करता है, जिनमें से प्रत्येक का अपना `eventData` स्कीमा:

| इवेंट प्रकार        | विवरण                              |
| ------------------- | ---------------------------------- |
| `quality_check`     | QA और निरीक्षण परिणाम              |
| `inventory_count`   | इन्वेंटरी माप                      |
| `safety_alert`      | सुरक्षा घटनाएँ और अलर्ट            |
| `custom`            | मुक्त-रूप इवेंट डेटा               |
| `operator_feedback` | मॉडल पूर्वानुमानों पर मानव फ़ीडबैक |

### डेटा प्रतिधारण

इवेंट एक कॉन्फ़िगर किए जा सकने वाले लुकबैक विंडो (डिफ़ॉल्ट: 14 दिन) के लिए बनाए रखे जाते हैं। `lookbackDays` मान क्वेरी प्रतिक्रियाओं में लौटाया जाता है ताकि आपको अपने workspace के लिए प्रभावी प्रतिधारण अवधि पता हो।

## Python SDK

Roboflow Python SDK विज़न इवेंट के साथ काम करने के लिए विधियाँ प्रदान करता है `Workspace` ऑब्जेक्ट पर। आप इवेंट बना सकते हैं, फ़िल्टर और पेजिनेशन के साथ उन्हें क्वेरी कर सकते हैं, छवियाँ अपलोड कर सकते हैं, और उपयोग केस प्रबंधित कर सकते हैं।

इवेंट स्कीमा, फ़िल्टरिंग विकल्प, और प्रतिक्रिया प्रारूपों पर पूर्ण विवरण के लिए देखें [Vision Events REST API दस्तावेज़ीकरण](#http-api).

### त्वरित शुरुआत

```python
import roboflow

roboflow.login()

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

# एक उपयोग केस बनाएं
result = ws.create_vision_event_use_case("manufacturing-qa")
use_case_id = result["id"]

# एक छवि अपलोड करें
img = ws.upload_vision_event_image("photo.jpg")

# अपलोड की गई छवि के साथ एक इवेंट बनाएं
ws.write_vision_event({
    "eventId": "c3d4e5f6-a1b2-4c3d-8e5f-6a7b8c9d0e1f",
    "eventType": "quality_check",
    "useCaseId": use_case_id,
    "timestamp": "2024-01-15T10:30:00Z",
    "images": [{"sourceId": img["sourceId"]}],
    "eventData": {"result": "pass"},
})

# इवेंट क्वेरी करें
for page in ws.query_all_vision_events(use_case_id):
    for evt in page:
        print(evt["eventId"], evt["eventType"])
```

### उपलब्ध विधियाँ

| विधि                                                                                                                                   | विवरण                                              |
| -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| [`upload_vision_event_image()`](/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-image.md#python-sdk)       | इवेंट में उपयोग के लिए एक छवि अपलोड करें           |
| [`write_vision_event()`](/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#python-sdk)                    | एक एकल विज़न इवेंट बनाएं                           |
| [`write_vision_events_batch()`](/deployment/hi/monitoring-and-analytics/vision-events/batch-create-vision-events.md#python-sdk)        | एक ही अनुरोध में 100 तक इवेंट बनाएं                |
| [`query_vision_events()`](/deployment/hi/monitoring-and-analytics/vision-events/query-events.md#python-sdk)                            | फ़िल्टर और पेजिनेशन के साथ इवेंट क्वेरी करें       |
| [`query_all_vision_events()`](/deployment/hi/monitoring-and-analytics/vision-events/query-events.md#paginate-through-all-results)      | सभी मेल खाने वाले इवेंट पर स्वतः-पेजिनेटिंग क्वेरी |
| [`list_vision_event_use_cases()`](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#python-sdk)                       | अपने workspace में उपयोग केस सूचीबद्ध करें         |
| [`create_vision_event_use_case()`](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#create-a-use-case)               | एक नया उपयोग केस बनाएं                             |
| [`rename_vision_event_use_case()`](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#rename-a-use-case)               | एक उपयोग केस का नाम बदलें                          |
| [`archive_vision_event_use_case()`](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#archive-a-use-case)             | एक उपयोग केस को संग्रहित करें                      |
| [`unarchive_vision_event_use_case()`](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#unarchive-a-use-case)         | एक उपयोग केस को संग्रह से बाहर निकालें             |
| [`get_vision_event_metadata_schema()`](/deployment/hi/monitoring-and-analytics/vision-events/get-custom-metadata-schema.md#python-sdk) | खोजे गए कस्टम मेटाडेटा फ़ील्ड प्रकार प्राप्त करें  |