उपयोग मामले

Vision Events को उद्देश्य के अनुसार Use Cases का उपयोग करके समूहित करें।

के बारे में

एक यूज़ केस समूहित करता है विज़न इवेंट्स जो एक सामान्य उद्देश्य और कस्टम मेटाडेटा संरचना साझा करते हैं, और हर इवेंट बिल्कुल एक ही यूज़ केस से संबंधित होता है। इस तरह इवेंट्स को व्यवस्थित करने से कैमरों, डिवाइसों और स्थानों में डेटा को फ़िल्टर और तुलना करना आसान हो जाता है, जो समान फ़ील्ड रिपोर्ट करते हैं। यह पृष्ठ समझाता है कि एक यूज़ केस कब उपयोग करना है बनाम कई, और उन्हें कैसे बनाना और प्रबंधित करना है।

वेब ऐप

यूज़ केस

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

एक बनाम अनेक यूज़ केस कब उपयोग करें

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

अलग-अलग यूज़ केस बनाएं जब मेटाडेटा संरचना मूल रूप से अलग हो। उदाहरण के लिए:

असेंबली लाइन QA - ट्रैक करता है line_id, shift, part_number
वेयरहाउस इन्वेंट्री - ट्रैक करता है aisle, shelf, item_type
कंस्ट्रक्शन साइट सुरक्षा - ट्रैक करता है zone, alert_type, contractor

एक यूज़ केस बनाएं

एजेंट के माध्यम से

यह Roboflow एजेंट विज़न इवेंट्स के साथ एक वर्कफ़्लो बनाते समय यूज़ केस स्वचालित रूप से बनाता है। यह मौजूदा यूज़ केस को चुनता है यदि वह उपयुक्त हो, या आपके वर्णित यूज़ केस के आधार पर एक नया बनाता है। आप एजेंट से सीधे एक नया यूज़ केस सेट अप करने के लिए भी कह सकते हैं।

डैशबोर्ड में

पर जाएँ विज़न इवेंट्स अपने वर्कस्पेस के बाएँ साइडबार में
क्लिक करें + यूज़ केस बनाएं
यूज़ केस के लिए एक नाम दर्ज करें

आप REST API के माध्यम से भी यूज़ केस बना सकते हैं, देखें प्रोग्रामेटिक रूप से यूज़ केस प्रबंधित करें.

यूज़ केस देखें

डैशबोर्ड में

Vision Events पृष्ठ आपके सभी यूज़ केसों की एक तालिका प्रदर्शित करता है, जिसमें दिखाया जाता है:

यूज़ केस का नाम
कुल इवेंट संख्या
अंतिम इवेंट टाइमस्टैम्प
उपयोग में इवेंट प्रकार

API के माध्यम से

अपने वर्कस्पेस में सभी यूज़ केस प्राप्त करें:

curl -X GET "https://api.roboflow.com/vision-events/use-cases" \\
  -H "Authorization: Bearer YOUR_API_KEY"

देखें Vision Events API संदर्भ पूर्ण प्रतिक्रिया प्रारूप के लिए।

प्रोग्रामेटिक रूप से यूज़ केस प्रबंधित करें

डैशबोर्ड के अलावा, आप REST API के माध्यम से यूज़ केस बना, उनका नाम बदल, उन्हें आर्काइव, और आर्काइव से वापस ला सकते हैं। इन एंडपॉइंट्स के लिए ऐसे API कुंजी की आवश्यकता होती है जिसमें vision-events:manage स्कोप (अनियंत्रित वर्कस्पेस API कुंजियों को डिफ़ॉल्ट रूप से पहुँच होती है)।

एक यूज़ केस बनाएं

curl -X POST "https://api.roboflow.com/vision-events/use-cases" \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -d '{ "name": "assembly-line-qa" }'

यूज़ केस का नाम बदलें

curl -X PUT "https://api.roboflow.com/vision-events/use-cases/USE_CASE_ID" \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -d '{ "name": "assembly-line-qa-v2" }'

यूज़ केस को आर्काइव या अनआर्काइव करें

curl -X POST "https://api.roboflow.com/vision-events/use-cases/USE_CASE_ID/archive" \\
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST "https://api.roboflow.com/vision-events/use-cases/USE_CASE_ID/unarchive" \\
  -H "Authorization: Bearer YOUR_API_KEY"

यूज़ केस को आर्काइव करें

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

कस्टम मेटाडेटा स्कीमा

इवेंट्स को किसी यूज़ केस में भेजे जाने के बाद, सिस्टम देखे गए फ़ील्ड और वैल्यू प्रकारों के आधार पर मेटाडेटा स्कीमा का अनुमान लगाता है। आप किसी यूज़ केस के लिए अनुमानित स्कीमा प्राप्त कर सकते हैं ताकि समझ सकें कि कौन-सी कुंजियाँ और वैल्यू प्रकार उपयोग में हैं:

curl -X GET "https://api.roboflow.com/vision-events/custom-metadata-schema/assembly-line-qa" \\
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "useCaseId": "assembly-line-qa",
  "fields": {
    "line_id": { "types": ["string"] },
    "shift": { "types": ["string"] },
    "temperature": { "types": ["number"] },
    "is_priority": { "types": ["boolean"] }
  }
}

देखें Vision Events API संदर्भ पूर्ण विवरण के लिए।

HTTP API

एक यूज़ केस बनाएं

अपने वर्कस्पेस में एक नया यूज़ केस बनाएं। यूज़ केस आपको डिप्लॉयमेंट संदर्भ (जैसे, "Manufacturing Line 1", "Warehouse Inventory") के अनुसार विज़न इवेंट्स को व्यवस्थित करने में मदद करते हैं।

आवश्यक स्कोप: vision-events:manage

Create a Use Case

post

Create a new use case in your workspace.

Authorizations

AuthorizationstringRequired

Roboflow API key passed as a Bearer token.

Body

namestring · min: 1 · max: 256Required

A name for the use case. Must be unique within the workspace.

Responses

201

Use case created successfully.

application/json

idstringOptional

namestringOptional

400

Validation error or duplicate name.

application/json

403

Insufficient permissions for this resource.

application/json

post/vision-events/use-cases

POST /vision-events/use-cases HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}

{
  "id": "text",
  "name": "text"
}

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

नाम (string, required): यूज़ केस के लिए एक नाम। यह 1 और 256 वर्णों के बीच होना चाहिए। नाम के आरंभ/अंत के whitespace को हटाया जाता है और यह वर्कस्पेस के भीतर अद्वितीय होना चाहिए।

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

curl -X POST "https://api.roboflow.com/vision-events/use-cases" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "name": "निर्माण लाइन 1"
  }'

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

{
  "id": "a1b3c8e1",
  "name": "निर्माण लाइन 1"
}

{
  "error": "इस नाम का एक समाधान पहले से मौजूद है"
}

{
  "error": "इस संसाधन के लिए अपर्याप्त अनुमतियाँ।"
}

नोट्स

नए यूज़ केस डिफ़ॉल्ट रूप से एक सक्रिय स्थिति के साथ बनाए जाते हैं।
यूज़ केस के नाम वर्कस्पेस के भीतर अद्वितीय होने चाहिए। किसी मौजूदा नाम के समान नाम वाला यूज़ केस बनाने का प्रयास एक 400 त्रुटि लौटाएगा।
यूज़ केस बनाने के बाद, आप उसके आईडी को useCaseId के रूप में विज़न इवेंट्स बनाते समय.

यूज़ केस अपडेट करें

किसी मौजूदा यूज़ केस के नाम या स्थिति को अपडेट करें।

आवश्यक स्कोप: vision-events:manage

Update a Use Case

put

Update the name or status of an existing use case.

Authorizations

AuthorizationstringRequired

Roboflow API key passed as a Bearer token.

Path parameters

useCaseIdstringRequired

The ID of the use case to update.

Body

namestring · min: 1 · max: 256Optional

A new name for the use case. Must be unique within the workspace.

statusstring · enumOptional

The new status for the use case.

Possible values:

Responses

200

Use case updated successfully.

application/json

idstringOptional

namestringOptional

400

Validation error or duplicate name.

application/json

403

Insufficient permissions for this resource.

application/json

404

Use case not found.

application/json

put/vision-events/use-cases/{useCaseId}

PUT /vision-events/use-cases/{useCaseId} HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "name": "text",
  "status": "active"
}

{
  "id": "text",
  "name": "text"
}

पथ पैरामीटर

useCaseId (string, required): अपडेट किए जाने वाले यूज़ केस की आईडी।

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

निम्न में से कम-से-कम एक फ़ील्ड प्रदान की जानी चाहिए:

नाम (string, optional): यूज़ केस के लिए एक नया नाम। यह 1 से 256 वर्णों के बीच होना चाहिए। यह वर्कस्पेस के भीतर अद्वितीय होना चाहिए।
स्थिति (string, optional): नई स्थिति। इनमें से एक सक्रिय या निष्क्रिय.

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

curl -X PUT "https://api.roboflow.com/vision-events/use-cases/a1b3c8e1" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "name": "निर्माण लाइन 2"
  }'

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

{
  "id": "a1b3c8e1",
  "name": "निर्माण लाइन 2"
}

{
  "error": "इस नाम का एक समाधान पहले से मौजूद है"
}

{
  "error": "समाधान नहीं मिला"
}

{
  "error": "इस संसाधन के लिए अपर्याप्त अनुमतियाँ।"
}

यूज़ केस सूचीबद्ध करें

अपने वर्कस्पेस में दर्ज किए गए विज़न इवेंट्स वाले सभी यूज़ केस सूचीबद्ध करें। यूज़ केस बनाने और प्रबंधित करने के तरीके जानने के लिए देखें यूज़ केस दस्तावेज़.

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

List Use Cases

get

List all use cases that have recorded vision events in your workspace.

Authorizations

AuthorizationstringRequired

Roboflow API key passed as a Bearer token.

Query parameters

statusstring · enumOptional

Filter by use case status. Defaults to active.

Default: activePossible values:

Responses

200

List of use cases.

application/json

lookbackDaysintegerOptional

403

Insufficient permissions for this resource.

application/json

get/vision-events/use-cases

GET /vision-events/use-cases HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "useCases": [
    {
      "id": "text",
      "name": "text",
      "status": "active",
      "workspaceId": "text",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  ],
  "lookbackDays": 1
}

क्वेरी पैरामीटर

स्थिति (string, optional): यूज़ केस स्थिति के आधार पर फ़िल्टर करें। इनमें से एक सक्रिय या निष्क्रिय. डिफ़ॉल्ट रूप से सक्रिय.

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

curl "https://api.roboflow.com/vision-events/use-cases" \\
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "useCases": [
    {
      "id": "a1b3c8e1",
      "name": "निर्माण लाइन 1",
      "status": "active",
      "workspaceId": "my-workspace",
      "createdAt": "2024-01-10T08:00:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "id": "d4e5f6a7",
      "name": "वेयरहाउस इन्वेंट्री",
      "status": "active",
      "workspaceId": "my-workspace",
      "createdAt": "2024-01-12T14:00:00.000Z",
      "updatedAt": "2024-01-15T09:00:00.000Z"
    }
  ],
  "lookbackDays": 14
}

{
  "error": "इस संसाधन के लिए अपर्याप्त अनुमतियाँ।"
}

यूज़ केस को आर्काइव करें

किसी यूज़ केस को इसकी स्थिति सेट करके आर्काइव करें निष्क्रियनिष्क्रिय पर। आर्काइव किए गए यूज़ केस डिफ़ॉल्ट रूप से सूचियों से छिपे रहते हैं और नए इवेंट इनजेशन को अस्वीकार करेंगे।

आवश्यक स्कोप: vision-events:manage

Archive a Use Case

post

Archive a use case by setting its status to inactive.

Authorizations

AuthorizationstringRequired

Roboflow API key passed as a Bearer token.

Path parameters

useCaseIdstringRequired

The ID of the use case to archive.

Responses

200

Use case archived successfully.

application/json

successbooleanOptional

403

Insufficient permissions for this resource.

application/json

404

Use case not found.

application/json

post/vision-events/use-cases/{useCaseId}/archive

POST /vision-events/use-cases/{useCaseId}/archive HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true
}

पथ पैरामीटर

useCaseId (string, required): आर्काइव किए जाने वाले यूज़ केस की आईडी।

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

curl -X POST "https://api.roboflow.com/vision-events/use-cases/a1b3c8e1/archive" \\
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "success": true
}

{
  "error": "समाधान नहीं मिला"
}

{
  "error": "इस संसाधन के लिए अपर्याप्त अनुमतियाँ।"
}

नोट्स

आर्काइव करना एक सॉफ्ट डिलीट है। यूज़ केस और उसके इवेंट संरक्षित रहते हैं, लेकिन सक्रिय सूचियों से छिपे होते हैं।
आर्काइव किए गए यूज़ केस देखने के लिए, उपयोग करें यूज़ केस सूचीबद्ध करें एंडपॉइंट, जिसमें status=inactive.
आप आर्काइव किए गए यूज़ केस को पुनर्स्थापित कर सकते हैं यूज़ केस को अनआर्काइव करें एंडपॉइंट का उपयोग करके।

यूज़ केस को अनआर्काइव करें

पहले से आर्काइव किए गए यूज़ केस को उसकी स्थिति वापस सेट करके पुनर्स्थापित करें सक्रिय.

आवश्यक स्कोप: vision-events:manage

Unarchive a Use Case

post

Restore a previously archived use case by setting its status back to active.

Authorizations

AuthorizationstringRequired

Roboflow API key passed as a Bearer token.

Path parameters

useCaseIdstringRequired

The ID of the use case to unarchive.

Responses

200

Use case unarchived successfully.

application/json

successbooleanOptional

400

Use case is not archived.

application/json

403

Insufficient permissions for this resource.

application/json

404

Use case not found.

application/json

post/vision-events/use-cases/{useCaseId}/unarchive

POST /vision-events/use-cases/{useCaseId}/unarchive HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true
}

पथ पैरामीटर

useCaseId (string, required): अनआर्काइव किए जाने वाले यूज़ केस की आईडी।

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

curl -X POST "https://api.roboflow.com/vision-events/use-cases/a1b3c8e1/unarchive" \\
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "success": true
}

{
  "error": "समाधान आर्काइव नहीं है"
}

{
  "error": "समाधान नहीं मिला"
}

{
  "error": "इस संसाधन के लिए अपर्याप्त अनुमतियाँ।"
}

नोट्स

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

Python SDK

प्रत्येक विज़न इवेंट एक यूज़ केस से संबद्ध होता है। Python SDK यूज़ केस बनाने, सूचीबद्ध करने, नाम बदलने, आर्काइव करने, और अनआर्काइव करने के तरीके प्रदान करता है।

यूज़ केस सूचीबद्ध करें

import roboflow

roboflow.login()

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

result = ws.list_vision_event_use_cases()

for uc in result["useCases"]:
    print(uc["id"], uc["name"], uc.get("status"))

आप स्थिति के आधार पर फ़िल्टर कर सकते हैं:

# केवल सक्रिय यूज़ केस सूचीबद्ध करें
result = ws.list_vision_event_use_cases(status="active")

एक यूज़ केस बनाएं

result = ws.create_vision_event_use_case("manufacturing-qa")
use_case_id = result["id"]
print(f"यूज़ केस बनाया गया: {use_case_id}")

यूज़ केस का नाम बदलें

ws.rename_vision_event_use_case("a1b3c8e1", "updated-name")

यूज़ केस को आर्काइव करें

ws.archive_vision_event_use_case("a1b3c8e1")

यूज़ केस को अनआर्काइव करें

ws.unarchive_vision_event_use_case("a1b3c8e1")

यूज़ केस प्रबंधन के बारे में अधिक विवरण के लिए, देखें REST API संदर्भ.

पिछलाविजन इवेंट इमेज अपलोड करें अगलाActive Learning

अंतिम अपडेट 2 दिन पहले

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