For the complete documentation index, see llms.txt. This page is also available as Markdown.

इवेंट्स क्वेरी करें

डैशबोर्ड में Vision Events खोजें, फ़िल्टर करें, और ब्राउज़ करें, Agent से प्राकृतिक भाषा में पूछें, या API के माध्यम से query करें

परिचय

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

वेब ऐप

इवेंट्स को क्वेरी और फ़िल्टर करें

Vision Events डैशबोर्ड में फ़िल्टरों का उपयोग करके विशिष्ट इवेंट्स खोजें या REST API के माध्यम से प्रोग्रामेटिक रूप से क्वेरी करें।

डैशबोर्ड में इवेंट्स ब्राउज़ करें

एक उपयोग मामला चुनें

Vision Events पृष्ठ से, उसके इवेंट्स देखने के लिए किसी उपयोग मामले पर क्लिक करें। इवेंट्स उल्टे कालानुक्रमिक क्रम में प्रदर्शित होते हैं।

इवेंट्स फ़िल्टर करें

परिणामों को सीमित करने के लिए इवेंट्स सूची के शीर्ष पर फ़िल्टर नियंत्रणों का उपयोग करें:

  • तारीख सीमा - प्रारंभ और समाप्ति टाइमस्टैम्प

  • इवेंट प्रकार - quality_check, inventory_count, safety_alert, custom, operator_feedback

  • डिवाइस - डिवाइस ID के आधार पर फ़िल्टर करें

  • स्ट्रीम - स्ट्रीम या कैमरा ID के आधार पर फ़िल्टर करें

  • वर्कफ़्लो - उन इवेंट्स को उत्पन्न करने वाले वर्कफ़्लो के आधार पर फ़िल्टर करें

  • डिटेक्शन - एक डिटेक्ट की गई ऑब्जेक्ट क्लास के आधार पर, वैकल्पिक कॉन्फिडेंस थ्रेशहोल्ड के साथ फ़िल्टर करें

  • फ़ीडबैक स्थिति - सही, गलत, अनिर्णीत, या कोई फ़ीडबैक नहीं

  • कस्टम मेटाडेटा - किसी भी कस्टम मेटाडेटा फ़ील्ड और मान के आधार पर फ़िल्टर करें

  • चेतावनियाँ - केवल वे इवेंट्स दिखाएँ जिनमें ingestion चेतावनियाँ थीं

आप इवेंट विवरण साइडबार में मानों (जैसे डिवाइस ID, स्ट्रीम, गुणवत्ता जाँच परिणाम, या कस्टम मेटाडेटा मान) पर क्लिक करके उन्हें जल्दी से फ़िल्टर के रूप में जोड़ सकते हैं।

फ़िल्टर चिप्स संपादन योग्य हैं -- किसी भी सक्रिय फ़िल्टर चिप पर क्लिक करके उसका मान या ऑपरेटर बदलेँ, बिना उसे हटाए और फिर से जोड़ें।

जब फ़िल्टर लागू होते हैं, तो एक कुल संख्या मेल खाने वाले इवेंट्स की परिणाम सूची के शीर्ष पर प्रदर्शित होती है। यह संख्या इवेंट सूची से स्वतंत्र रूप से अपडेट होती है, इसलिए आप देख सकते हैं कि आपके फ़िल्टरों से कितने इवेंट्स मेल खाते हैं, भले ही इवेंट्स अभी भी लोड हो रहे हों।

इवेंट विवरण देखें

सूची में किसी भी इवेंट पर क्लिक करके उसके पूर्ण विवरण देखें:

  • स्रोत छवि और कोई भी आउटपुट छवियाँ

  • सभी स्रोत मेटाडेटा (डिवाइस, स्ट्रीम, वर्कफ़्लो)

  • ऑब्जेक्ट डिटेक्शन, वर्गीकरण, और सेगमेंटेशन उनके कॉन्फिडेंस स्कोर सहित

  • इवेंट-प्रकार-विशिष्ट डेटा (उदा.: पास/फेल परिणाम, आइटम संख्या, अलर्ट गंभीरता)

  • कस्टम मेटाडेटा की-वैल्यू जोड़े

डिटेक्शन दिखाएँ

जब किसी इवेंट में प्रेडिक्शन डेटा (ऑब्जेक्ट डिटेक्शन, इंस्टेंस सेगमेंटेशन, या कीपॉइंट) होता है, तो छवि के ऊपर एक "डिटेक्शन दिखाएँ" चेकबॉक्स दिखाई देता है। इसे सक्षम करें ताकि स्रोत छवि के ऊपर बॉक्स, सेगमेंटेशन बहुभुज, और कॉन्फिडेंस स्कोर सहित लेबल ओवरले किए जा सकें।

यह तब उपयोगी होता है जब आपकी पाइपलाइन केवल मूल इनपुट छवि सहेजती है और आप एक अलग आउटपुट छवि संग्रहीत किए बिना यह देखना चाहते हैं कि मॉडल ने क्या डिटेक्ट किया।

अलग आउटपुट छवि देखते समय चेकबॉक्स छिपा रहता है, क्योंकि उनमें पहले से ही डिटेक्शन रेंडर किए गए होते हैं।

स्वतः-अंतिम रूप दिए गए इवेंट्स

auto-finalized के रूप में चिह्नित एक इवेंट को वीडियो के अपलोड पूरा होने से पहले एज डिवाइस पर स्वतः बंद कर दिया गया था, इसलिए वीडियो अनुपलब्ध है। इवेंट में फिर भी उसका परिणाम और स्थिर छवियाँ मौजूद रहती हैं। इवेंट कार्ड एक संकेतक दिखाता है, और विवरण दृश्य में अंतिम रूप दिए जाने का समय दिखता है। यह केवल Edge Device Backup.

Agent से पूछें

आप हाथ से फ़िल्टर बनाने के बजाय प्राकृतिक भाषा में इवेंट्स क्वेरी कर सकते हैं। खोलें Roboflow Agent बाएँ साइडबार में "Agent" पर क्लिक करके, फिर किसी उपयोग मामले के बारे में पूछें (उदा.: "पिछले हफ्ते assembly-line-qa में कितनी विफलताएँ थीं?", "समय के साथ दोष दर कैसे बदली है?", "प्रति स्ट्रीम औसत आइटम संख्या क्या है?").

Agent आपके इवेंट डेटा से क्वेरी करके उत्तर देता है, इसलिए संख्याएँ वही दर्शाती हैं जो आपके इवेंट्स में वास्तव में है। यह कर सकता है:

  • किसी समय सीमा, इवेंट प्रकार, या परिणाम से मेल खाने वाले इवेंट्स की संख्या गिनना।

  • समय के साथ पास और फेल दरों को ट्रैक करना और बताना कि दोष दर सुधर रही है या बिगड़ रही है।

  • किसी संख्यात्मक फ़ील्ड के योग, औसत, न्यूनतम, अधिकतम, या अद्वितीय मानों की संख्या निकालना।

  • इवेंट फ़ील्ड या कस्टम मेटाडेटा के आधार पर कुल को समूहित करना, या उन्हें दिन या सप्ताह के अनुसार बकेट करना।

यदि कोई प्रश्न आपके वर्कस्पेस की रिटेंशन विंडोसे आगे चला जाता है, तो Agent शून्य उत्तर देने के बजाय आपको सबसे प्रारंभिक तारीख बताता है जिसे वह क्वेरी कर सकता है। तारीख सीमाएँ और समय बकेट UTC का उपयोग करते हैं।

इवेंट्स के बारे में पूछने के लिए "View Vision Events" अनुमति.

एक बार के उत्तर के बजाय आवर्ती ईमेल किए गए सारांश के लिए, देखें सारांश रिपोर्ट.

HTTP API

API के माध्यम से इवेंट्स क्वेरी करें

क्वेरी एंडपॉइंट डैशबोर्ड के समान फ़िल्टरों के साथ-साथ कर्सर-आधारित पेजिनेशन का समर्थन करता है। पैरामीटरों और प्रतिक्रिया फ़ील्डों की पूरी सूची के लिए देखें Vision Events API संदर्भ.

मूल क्वेरी

प्रतिक्रिया:

पेजिनेशन

परिणाम कर्सर का उपयोग करके पेजिनेट किए जाते हैं। यदि प्रतिक्रिया में एक nextCursor मान और hasMore है सत्य, अगला पृष्ठ प्राप्त करने के लिए अपनी अगली अनुरोध में कर्सर पास करें:

तब तक जारी रखें जब तक hasMore है असत्य.

इवेंट प्रकार के अनुसार फ़िल्टर करें

एकल इवेंट प्रकार क्वेरी करें:

या कई इवेंट प्रकार (अधिकतम 20):

फ़ीडबैक स्थिति के अनुसार फ़िल्टर करें

उपयोग करें feedbackStatus यह पता लगाने के लिए कि ऑपरेटरों ने उनकी समीक्षा की है या नहीं और उन्हें कैसी रेटिंग दी गई है:

मान्य मान: सही, गलत, अनिर्णीत, none. के लिए none उन इवेंट्स को खोजने के लिए जिनकी अभी समीक्षा नहीं हुई है।

कस्टम मेटाडेटा के अनुसार फ़िल्टर करें

उपयोग करें customMetadataFilters अपने स्वयं के मेटाडेटा फ़ील्डों के आधार पर इवेंट्स फ़िल्टर करने के लिए:

Vision Events क्वेरी करें

फ़िल्टर, समय सीमाओं, और पेजिनेशन के साथ Vision Events क्वेरी करें। यह एंडपॉइंट इवेंट प्रकार, डिवाइस संदर्भ, डिटेक्शन क्लास, कस्टम मेटाडेटा, और इवेंट-विशिष्ट फ़ील्डों के आधार पर फ़िल्टरिंग का समर्थन करता है।

आवश्यक स्कोप: vision-events:read या device:read

Query Vision Events

post

Query vision events with filters, time ranges, and pagination.

Authorizations
AuthorizationstringRequired

Roboflow API key passed as a Bearer token.

Body
useCaseIdstringRequired

The use case ID to query events for.

startTimestring · date-timeOptional
endTimestring · date-timeOptional
hasWarningsbooleanOptional
cursorstringOptional
limitinteger · min: 1 · max: 1000OptionalDefault: 100
Responses
200

Query results.

application/json
hasMorebooleanOptional
nextCursorstringOptional
lookbackDaysintegerOptional
deprecationsstring[]Optional
post/vision-events/query

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

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

आवश्यक फ़ील्ड:

  • useCaseId (string): इवेंट्स क्वेरी करने के लिए उपयोग मामले की ID। देखें उपयोग मामले अपनी उपयोग मामले की ID कैसे खोजें, इसके लिए।

समय सीमा फ़िल्टर:

  • startTime (string, ISO 8601, वैकल्पिक): समय सीमा की शुरुआत।

  • endTime (string, ISO 8601, वैकल्पिक): समय सीमा का अंत।

इवेंट प्रकार फ़िल्टर:

  • eventTypes (स्ट्रिंगों की सरणी, अधिकतम 20, वैकल्पिक): एक या अधिक इवेंट प्रकारों के लिए फ़िल्टर करें।

संदर्भ फ़िल्टर:

प्रत्येक संदर्भ फ़िल्टर एक ऑब्जेक्ट है जिसमें operator और value:

  • deviceId (ऑब्जेक्ट, वैकल्पिक): डिवाइस के आधार पर फ़िल्टर करें। ऑपरेटर: eq, neq.

  • streamId (ऑब्जेक्ट, वैकल्पिक): स्ट्रीम के आधार पर फ़िल्टर करें। ऑपरेटर: eq, neq.

  • workflowId (ऑब्जेक्ट, वैकल्पिक): वर्कफ़्लो के आधार पर फ़िल्टर करें। ऑपरेटर: eq, neq.

  • externalId (ऑब्जेक्ट, वैकल्पिक): बाहरी ID के आधार पर फ़िल्टर करें। ऑपरेटर: eq, neq.

डिटेक्शन फ़िल्टर:

  • detection (ऑब्जेक्ट, वैकल्पिक): डिटेक्शन क्लास नाम के आधार पर इवेंट्स फ़िल्टर करें, वैकल्पिक रूप से प्रति-डिटेक्शन कॉन्फिडेंस थ्रेशहोल्ड के साथ। ऑपरेटर: eq, neq, in, not_in. के लिए in और not_in, मान के रूप में स्ट्रिंगों की एक सरणी पास करें (अधिकतम 50)।

    • confidence (ऑब्जेक्ट, वैकल्पिक): प्रति-डिटेक्शन कॉन्फिडेंस थ्रेशहोल्ड। केवल इसके साथ समर्थित eq और in क्लास ऑपरेटर। क्लास और कॉन्फिडेंस एक ही डिटेक्शन पर मेल खाना चाहिए।

      • operator (string): इनमें से एक gt, gte, lt, lte.

      • value (number): 0 और 1 के बीच कॉन्फिडेंस थ्रेशहोल्ड।

न्यूनतम कॉन्फिडेंस के साथ क्लास के अनुसार फ़िल्टर करें:

यह detection फ़िल्टर का पहले नाम था detectionClass. पुराना नाम अब स्वीकार नहीं किया जाता।

छवि और चेतावनी फ़िल्टर:

  • imageCount (ऑब्जेक्ट, वैकल्पिक): इवेंट से संलग्न छवियों की संख्या के आधार पर फ़िल्टर करें। ऑपरेटर: eq, neq, gt, gte, lt, lte.

  • hasWarnings (बूलियन, वैकल्पिक): उन इवेंट्स के लिए फ़िल्टर करें जिनमें ingestion चेतावनियाँ हैं या नहीं हैं।

कस्टम मेटाडेटा फ़िल्टर:

  • customMetadataFilters (सरणी, अधिकतम 20, वैकल्पिक): कस्टम मेटाडेटा फ़ील्डों के आधार पर फ़िल्टर करें। प्रत्येक फ़िल्टर में होता है:

    • field (string): मेटाडेटा फ़ील्ड का नाम।

    • operator (string): तुलना ऑपरेटर।

    • value: तुलना के लिए मान।

    • type (string): मान का प्रकार, इनमें से एक स्ट्रिंग, संख्या, या बूलियन.

प्रकार के अनुसार उपलब्ध ऑपरेटर:

प्रकार
ऑपरेटर

स्ट्रिंग

eq, neq, in, not_in

संख्या

eq, neq, gt, gte, lt, lte

बूलियन

eq, neq

इवेंट फ़ील्ड फ़िल्टर:

  • eventFieldFilters (सरणी, अधिकतम 20, वैकल्पिक): इवेंट-विशिष्ट फ़ील्डों के आधार पर फ़िल्टर करें। प्रत्येक फ़िल्टर में होता है:

    • column (string): इनमें से एक result, location, item_count, item_type, alert_type, severity, या feedback.

    • operator (string): तुलना ऑपरेटर (eq, neq, gt, gte, lt, lte, in, not_in).

    • value: तुलना के लिए मान।

पेजिनेशन:

  • cursor (string, वैकल्पिक): अगला पृष्ठ लाने के लिए पिछली प्रतिक्रिया का कर्सर।

  • limit (number, वैकल्पिक, डिफ़ॉल्ट 100, अधिकतम 1000): प्रति पृष्ठ लौटाए जाने वाले इवेंट्स की संख्या।

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

जब hasMore है सत्य, उपयोग करें nextCursor अपने अगले अनुरोध में मान का उपयोग करके परिणामों का अगला पृष्ठ प्राप्त करें:

पायथन SDK

फ़िल्टर, समय सीमाओं, और पेजिनेशन के साथ Vision Events क्वेरी करें।

एकल पृष्ठ क्वेरी

उपयोग करें query_vision_events() का उपयोग करके परिणामों का एक एकल पृष्ठ प्राप्त करें:

आप अतिरिक्त फ़िल्टर भी कीवर्ड आर्ग्यूमेंट्स के रूप में पास कर सकते हैं। इन्हें सीधे API को भेज दिया जाता है:

मैनुअल पेजिनेशन के लिए, cursor पैरामीटर का उपयोग करें nextCursor पिछली प्रतिक्रिया के मान के साथ:

सभी परिणामों के माध्यम से पेजिनेट करें

उपयोग करें query_all_vision_events() सभी मेल खाने वाले इवेंट्स में स्वचालित रूप से पेजिनेट करने के लिए। यह एक बार में इवेंट्स का एक पेज देता है:

उपलब्ध फ़िल्टर, ऑपरेटरों, और प्रतिक्रिया प्रारूपों के पूर्ण विवरण के लिए, देखें REST API संदर्भ.

अंतिम अपडेट

क्या यह उपयोगी था?