> 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

रिकॉर्ड करें, खोजें, और विश्लेषण करें कि production में आपके डिप्लॉय किए गए computer vision models क्या देखते हैं।

## परिचय

### अवलोकन

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>" %}

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

#### उपयोग के उदाहरण

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

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

### इस सेक्शन में

* [इवेंट भेजें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/send-events.md) - वर्कफ़्लो ब्लॉक, REST API या एज डिवाइस बैकअप से इवेंट भेजें।
* [इवेंट क्वेरी करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/query-events.md) - डैशबोर्ड में इवेंट फ़िल्टर करें, Agent से सामान्य भाषा में पूछें या API के ज़रिए क्वेरी करें।
* [ट्रेनिंग के लिए इमेज जोड़ें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/add-images-for-training.md) - कैप्चर की गई इवेंट इमेज को किसी प्रोजेक्ट में ले जाकर मॉडल को ट्रेन करें।
* [ऑटोमेशन](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/automations.md) - मेल खाने वाले इवेंट की इमेज किसी प्रोजेक्ट में भेजें या बिना हाथ से किए ईमेल अलर्ट भेजें।
* [इवेंट न आने पर अलर्ट](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/no-events-alerts.md) - जब कोई कैमरा, स्ट्रीम या वर्कफ़्लो इवेंट भेजना बंद कर दे, तो ईमेल पाएँ।
* [ऑपरेटर फ़ीडबैक](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/operator-feedback.md) - टीम के सदस्यों को इवेंट को सही, गलत या अनिर्णीत के रूप में चिह्नित करने दें।
* [सारांश रिपोर्ट](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/summary-reports.md) - अपनी टीम को उपयोग के उदाहरण का नियमित सारांश ईमेल करें, जिसमें मुख्य आँकड़े और पूरी रिपोर्ट का लिंक हो।
* [इवेंट हटाएँ](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/delete-events.md) - Use Case से वे इवेंट हटाएँ जिनकी अब आपको ज़रूरत नहीं है।

## HTTP API

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

Vision Events API की मदद से आप ये काम कर सकते हैं:

* [Vision Event इमेज अपलोड करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-image.md#http-api)
* [Vision Event वीडियो अपलोड करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-video.md#http-api)
* [Vision Event बनाएँ](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api)
* [Vision Events को बैच में बनाएँ](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/batch-create-vision-events.md#http-api)
* [Vision Event बंडल अपलोड करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-bundle.md#http-api)
* [Vision Events पर क्वेरी करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/query-events.md#http-api)
* [Use Cases की सूची बनाएँ](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#http-api)
* [कस्टम मेटाडेटा स्कीमा प्राप्त करें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/get-custom-metadata-schema.md#http-api)

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

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

```
Authorization: Bearer YOUR_API_KEY
```

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

* **पढ़ने की कार्रवाइयाँ** (क्वेरी, सूची, स्कीमा): `vision-events:read` या `device:read`
* **लिखने की कार्रवाइयाँ** (बनाना, बैच, अपलोड): `vision-events:write` या `device:update`

### उपयोग के उदाहरण

हर vision event किसी use case से जुड़ा होता है। Use Cases बनाने और प्रबंधित करने का तरीका जानने के लिए, देखें [Use Cases का दस्तावेज़](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md).

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

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

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

| इवेंट का प्रकार     | विवरण                                       |
| ------------------- | ------------------------------------------- |
| `quality_check`     | गुणवत्ता आश्वासन और निरीक्षण के नतीजे       |
| `inventory_count`   | इन्वेंट्री के माप                           |
| `safety_alert`      | सुरक्षा संबंधी घटनाएँ और अलर्ट              |
| `custom`            | मनमाने ढंग से तय किया गया इवेंट डेटा        |
| `operator_feedback` | मॉडल की भविष्यवाणियों पर मानवीय प्रतिक्रिया |

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

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

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

## 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_query</code></td><td>किसी उपयोग के मामले के लिए प्रोडक्शन विज़न इवेंट की क्वेरी करें।</td></tr><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_custom_metadata_schema_get</code></td><td>किसी उपयोग के मामले के लिए खोजी गई कस्टम मेटाडेटा स्कीमा प्राप्त करें।</td></tr></tbody></table>
