> 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 datastore है, जो आपके deployed computer vision model से visual information के साथ defect की पहचान या inventory की count जैसे महत्वपूर्ण events को capture कर सकता है। इससे आपको production में आपका vision system जो कुछ भी observe करता है, उसका एक searchable, filterable history मिलता है। ### Vision Event क्या है? Vision Event एक timestamped record है, जो तब बनाया जाता है जब कोई model एक image process करता है। हर event वैकल्पिक रूप से इनमें से कुछ capture कर सकता है: * **छवियाँ**: प्रोसेस की गई मूल छवियाँ और उनसे संबंधित output images * **पूर्वानुमान**: मॉडल द्वारा लौटाए गए object detections, classifications, instance segmentations, या keypoints * **स्रोत मेटाडेटा**: किस device, stream, या workflow ने event उत्पन्न किया * **कस्टम मेटाडेटा**: आपके domain के लिए आपके द्वारा परिभाषित key-value pairs (जैसे `line_number`, `shift`, `part_number`) प्रोग्रामेटिक एक्सेस के लिए, देखें [Vision Events API Reference](#http-api). {% embed url="" %} ### मुख्य अवधारणाएँ #### उपयोग के मामले एक **उपयोग का मामला** उन events को समूहित करता है जिनका एक सामान्य उद्देश्य और कस्टम मेटाडेटा संरचना होती है। एक ही Use Case के events आमतौर पर समान metadata fields भेजते हैं, ताकि आप उन्हें लगातार filter और query कर सकें। उदाहरण के लिए, "Defect Detection" Use Case में हमेशा शामिल हो सकता है `line_id`, `shift`, और `part_number` भले ही events कई factories या camera locations से आते हों। जब metadata संरचना मूल रूप से अलग हो, तो अलग-अलग Use Cases बनाएं (जैसे "PPE Compliance" ट्रैक करता है `zone` और `alert_type` इसके बजाय)। ### इस अनुभाग में * [Events भेजें](/deployment/hi/monitoring-and-analytics/vision-events/send-events.md) - Workflow block, REST API, या edge device backup से events भेजें। * [Events क्वेरी करें](/deployment/hi/monitoring-and-analytics/vision-events/query-events.md) - dashboard में events को filter करें, Agent से प्राकृतिक भाषा में पूछें, या API के माध्यम से query करें। * [Training के लिए Images जोड़ें](/deployment/hi/monitoring-and-analytics/vision-events/add-images-for-training.md) - captured event images को किसी project में ले जाकर model train करें। * [Operator Feedback](/deployment/hi/monitoring-and-analytics/vision-events/operator-feedback.md) - team members को events को सही, गलत, या अनिश्चित के रूप में चिह्नित करने दें। * [सारांश रिपोर्टें](/deployment/hi/monitoring-and-analytics/vision-events/summary-reports.md) - अपनी team को किसी Use Case का आवर्ती digest email करें। * [Events हटाएँ](/deployment/hi/monitoring-and-analytics/vision-events/delete-events.md) - जिन events की अब आवश्यकता नहीं है, उन्हें Use Case से हटाएँ। ## HTTP API Vision Events API आपको अपने computer vision deployments से structured events record करने, फिर उन्हें query और analyze करने की सुविधा देता है। Events में images, detection annotations, custom metadata, और quality checks, inventory counts, safety alerts, और अधिक के लिए type-specific data शामिल हो सकता है। Vision Events API के साथ, आप कर सकते हैं: * [Vision Event Image अपलोड करें](/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) * [Vision Events का Batch Create करें](/deployment/hi/monitoring-and-analytics/vision-events/batch-create-vision-events.md#http-api) * [Vision Event Bundle अपलोड करें](/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) * [Custom 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 को विशिष्ट [scoped API key](https://docs.roboflow.com/reference/authentication/authentication/scoped-api-keys) अनुमतियों की आवश्यकता होती है: * **Read operations** (query, list, schema): `vision-events:read` या `device:read` * **Write operations** (create, batch, upload): `vision-events:write` या `device:update` ### उपयोग के मामले हर vision event एक use case से जुड़ा होता है। Use cases बनाने और प्रबंधित करने का तरीका जानने के लिए देखें [Use Cases documentation](/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 रिकॉर्ड किए हैं। ### Event Types API पाँच event types का समर्थन करता है, और हर एक का अपना `eventData` schema होता है: | Event Type | विवरण | | ------------------- | ----------------------------------- | | `quality_check` | QA और inspection परिणाम | | `inventory_count` | Inventory माप | | `safety_alert` | Safety incidents और alerts | | `custom` | मुक्त-रूप event data | | `operator_feedback` | मॉडल पूर्वानुमानों पर मानव feedback | ### Data Retention Events को एक configurable lookback window के लिए retain किया जाता है (default: 14 days). `lookbackDays` मान query responses में लौटाया जाता है, ताकि आपको अपने workspace के लिए प्रभावी retention period पता रहे। ## Python SDK Roboflow Python SDK vision events के साथ काम करने के लिए methods प्रदान करता है `Workspace` object पर। आप events बना सकते हैं, filters और pagination के साथ उन्हें query कर सकते हैं, images अपलोड कर सकते हैं, और use cases प्रबंधित कर सकते हैं। Event schemas, filtering options, और response formats के पूरे विवरण के लिए, देखें [Vision Events REST API documentation](#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"] # एक image अपलोड करें img = ws.upload_vision_event_image("photo.jpg") # अपलोड की गई image के साथ एक 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"}, }) # Events क्वेरी करें 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 में उपयोग के लिए image अपलोड करें | | [`write_vision_event()`](/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#python-sdk) | एकल 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) | खोजे गए custom metadata field types प्राप्त करें | ## MCP Server अपने AI agent को से कनेक्ट करें [MCP Server](https://docs.roboflow.com/agents/mcp-server) और यह इन tools के साथ production events देख सकता है:
Toolविवरण
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 प्राप्त करें।