> 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 datastore है जो महत्वपूर्ण घटनाओं को कैप्चर कर सकता है, जैसे किसी दोष का पता लगना या इन्वेंट्री की गणना, साथ ही आपके डिप्लॉय किए गए कंप्यूटर विज़न मॉडल से प्राप्त विज़ुअल जानकारी। इससे आपको प्रोडक्शन में आपका विज़न सिस्टम जो कुछ भी देखता है, उसका एक खोजने योग्य, फ़िल्टर करने योग्य इतिहास मिलता है। ### Vision Event क्या है? Vision Event एक timestamp वाला रिकॉर्ड है, जो तब बनाया जाता है जब कोई मॉडल किसी image को process करता है। प्रत्येक event वैकल्पिक रूप से यह कैप्चर कर सकता है: * **छवियाँ**: मूल छवियाँ जिन्हें process किया गया था और उनसे संबंधित output छवियाँ * **वीडियो**: अधिकतम चार वीडियो क्लिप, जो event के आसपास क्या हुआ यह दिखाती हैं * **पूर्वानुमान**: मॉडल द्वारा लौटाए गए object detections, classifications, instance segmentations, या keypoints * **स्रोत metadata**: किस device, stream, या workflow ने event generate किया * **कस्टम metadata**: आपके domain के लिए आपके द्वारा परिभाषित key-value pairs (उदा. `line_number`, `shift`, `part_number`) प्रोग्रामेटिक access के लिए, देखें [Vision Events API Reference](#http-api). {% embed url="" %} ### मुख्य अवधारणाएँ #### उपयोग मामले एक **उपयोग मामला** उन घटनाओं को समूहित करता है जो एक सामान्य उद्देश्य और कस्टम metadata संरचना साझा करती हैं। एक ही Use Case की घटनाएँ आमतौर पर समान metadata fields भेजती हैं, ताकि आप उन्हें लगातार filter और query कर सकें। उदाहरण के लिए, "Defect Detection" Use Case में हमेशा शामिल हो सकता है `line_id`, `shift`, और `part_number` भले ही घटनाएँ कई कारखानों या कैमरा स्थानों से आएँ। जब metadata संरचना मूल रूप से अलग हो (उदा. "PPE Compliance" ट्रैक करता है `zone` और `alert_type` इसके बजाय)। ### इस अनुभाग में * [ईवेंट भेजें](/deployment/hi/monitoring-and-analytics/vision-events/send-events.md) - किसी Workflow block, REST API, या edge device backup से events भेजें। * [ईवेंट क्वेरी करें](/deployment/hi/monitoring-and-analytics/vision-events/query-events.md) - dashboard में events filter करें, Agent से प्राकृतिक भाषा में पूछें, या API के माध्यम से query करें। * [प्रशिक्षण के लिए छवियाँ जोड़ें](/deployment/hi/monitoring-and-analytics/vision-events/add-images-for-training.md) - कैप्चर की गई event छवियों को किसी project में ले जाएँ ताकि model को train किया जा सके। * [ऑपरेटर प्रतिक्रिया](/deployment/hi/monitoring-and-analytics/vision-events/operator-feedback.md) - टीम सदस्यों को events को सही, गलत, या अनिर्णीत के रूप में चिह्नित करने दें। * [सारांश रिपोर्ट](/deployment/hi/monitoring-and-analytics/vision-events/summary-reports.md) - अपनी टीम को किसी Use Case का नियमित digest ईमेल करें। * [ईवेंट हटाएँ](/deployment/hi/monitoring-and-analytics/vision-events/delete-events.md) - किसी Use Case से उन events को हटाएँ जिनकी अब आपको आवश्यकता नहीं है। ## HTTP API Vision Events API आपको अपने computer vision deployments से संरचित events रिकॉर्ड करने, फिर उन्हें query और analyze करने की सुविधा देता है। Events में छवियाँ, video clips, detection annotations, custom metadata, और quality checks, inventory counts, safety alerts, तथा अन्य के लिए type-specific data शामिल हो सकता है। Vision Events API के साथ, आप यह कर सकते हैं: * [Vision Event की छवि अपलोड करें](/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-image.md#http-api) * [Vision Event का वीडियो अपलोड करें](/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-video.md#http-api) * [एक Vision Event बनाएँ](/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api) * [Vision Events को बैच में बनाएँ](/deployment/hi/monitoring-and-analytics/vision-events/batch-create-vision-events.md#http-api) * [Vision Event बंडल अपलोड करें](/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-bundle.md#http-api) * [Vision Events क्वेरी करें](/deployment/hi/monitoring-and-analytics/vision-events/query-events.md#http-api) * [Use Cases सूचीबद्ध करें](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#http-api) * [कस्टम metadata schema प्राप्त करें](/deployment/hi/monitoring-and-analytics/vision-events/get-custom-metadata-schema.md#http-api) ### प्रमाणीकरण सभी Vision Events endpoints आपके Roboflow API key के साथ Bearer token authentication का उपयोग करते हैं: ``` Authorization: Bearer YOUR_API_KEY ``` Vision Events endpoints के लिए विशिष्ट [स्कोप्ड 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` ### उपयोग मामले प्रत्येक vision event एक use case से जुड़ा होता है। Use cases बनाने और प्रबंधित करने का तरीका जानने के लिए, देखें [Use Cases दस्तावेज़](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md). आप यह भी कर सकते हैं [मौजूदा use cases सूचीबद्ध करें](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#http-api) जिनमें API के माध्यम से events रिकॉर्ड किए गए हैं। ### ईवेंट प्रकार API पाँच event types का समर्थन करता है, जिनमें से प्रत्येक का अपना `eventData` schema है: | ईवेंट प्रकार | विवरण | | ------------------- | -------------------------------------- | | `quality_check` | QA और inspection परिणाम | | `inventory_count` | इन्वेंट्री माप | | `safety_alert` | सुरक्षा घटनाएँ और अलर्ट | | `custom` | मुक्त-रूप event data | | `operator_feedback` | मॉडल पूर्वानुमानों पर मानव प्रतिक्रिया | ### डेटा प्रतिधारण Events को एक कॉन्फ़िगर करने योग्य lookback window के लिए रखा जाता है (डिफ़ॉल्ट: 14 दिन)। `lookbackDays` मान query responses में लौटाया जाता है, ताकि आपको अपने workspace के लिए प्रभावी प्रतिधारण अवधि पता रहे। ## Python SDK Roboflow Python SDK Workspace object पर vision events के साथ काम करने के लिए methods प्रदान करता है। आप events बना सकते हैं, filters और pagination के साथ उन्हें query कर सकते हैं, images upload कर सकते हैं, और use cases प्रबंधित कर सकते हैं। `वर्कस्पेस` object. आप events बना सकते हैं, filters और pagination के साथ उन्हें query कर सकते हैं, images upload कर सकते हैं, और use cases प्रबंधित कर सकते हैं। event schemas, filtering विकल्पों, और response formats के पूर्ण विवरण के लिए, देखें [Vision Events REST API दस्तावेज़](#http-api). ### त्वरित शुरुआत ```python import roboflow roboflow.login() rf = roboflow.Roboflow() ws = rf.workspace() # एक use case बनाएँ result = ws.create_vision_event_use_case("manufacturing-qa") use_case_id = result["id"] # एक छवि अपलोड करें img = ws.upload_vision_event_image("photo.jpg") # अपलोड की गई छवि के साथ एक event बनाएँ 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) | events में उपयोग के लिए एक छवि अपलोड करें | | [`write_vision_event()`](/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#python-sdk) | एक single vision event बनाएँ | | [`write_vision_events_batch()`](/deployment/hi/monitoring-and-analytics/vision-events/batch-create-vision-events.md#python-sdk) | एक request में अधिकतम 100 events बनाएँ | | [`query_vision_events()`](/deployment/hi/monitoring-and-analytics/vision-events/query-events.md#python-sdk) | filters और pagination के साथ events क्वेरी करें | | [`query_all_vision_events()`](/deployment/hi/monitoring-and-analytics/vision-events/query-events.md#paginate-through-all-results) | सभी matching events पर auto-paginating query | | [`list_vision_event_use_cases()`](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#python-sdk) | अपने workspace में use cases सूचीबद्ध करें | | [`create_vision_event_use_case()`](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#create-a-use-case) | एक नया use case बनाएँ | | [`rename_vision_event_use_case()`](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#rename-a-use-case) | एक use case का नाम बदलें | | [`archive_vision_event_use_case()`](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#archive-a-use-case) | एक use case archive करें | | [`unarchive_vision_event_use_case()`](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md#unarchive-a-use-case) | एक use case unarchive करें | | [`get_vision_event_metadata_schema()`](/deployment/hi/monitoring-and-analytics/vision-events/get-custom-metadata-schema.md#python-sdk) | खोजे गए कस्टम metadata field types प्राप्त करें | ## MCP Server अपने AI agent को [MCP Server](https://docs.roboflow.com/agents/mcp-server) से कनेक्ट करें, और यह इन tools के साथ production events देख सकता है:
टूलविवरण
vision_events_queryकिसी use case के लिए production vision events क्वेरी करें।
vision_events_use_cases_listworkspace में vision event use cases सूचीबद्ध करें।
vision_events_use_case_createएक नया vision event use case बनाएँ।
vision_events_custom_metadata_schema_getकिसी use case के लिए खोजा गया custom metadata schema प्राप्त करें।