इवेंट भेजें

अपने डिप्लॉय किए गए models से Vision Events भेजने के तीन तरीके।

इवेंट भेजें

आप Vision Events को Workflow block, REST API, या edge device backup का उपयोग करके भेज सकते हैं।

• वर्कफ़्लो ब्लॉक - Workflows उपयोगकर्ताओं को संभवतः आधिकारिक Roboflow block का उपयोग करना सबसे आसान लगेगा

• REST API - जो उपयोगकर्ता workflows के बाहर मॉडल तैनात करना चुनते हैं, वे हमारी REST API का उपयोग कर सकते हैं

• एज डिवाइस बैकअप - Roboflow Edge डिवाइस तैनात करने वाले उपयोगकर्ताओं को डिवाइस पर स्थानीय event store से स्वचालित backup कॉन्फ़िगर करना सबसे सुविधाजनक लगेगा

वर्कफ़्लो ब्लॉक

अधिकांश उपयोगकर्ताओं के लिए अनुशंसित तरीका। जोड़ें Vision Event ब्लॉक को किसी भी Roboflow Workflow में जोड़ें ताकि बिना किसी कोड के inference results से अपने-आप इवेंट बन जाएँ।

The Roboflow Agent आपके लिए इसे सेट अप कर सकता है। जब आप Agent से ऐसा Workflow बनाने को कहते हैं जो एक मॉडल चलाता है, तो वह अपने-आप एक Vision Events block जोड़ता है और उसे सही Use Case.

सेटअप

1

वर्कफ़्लो एडिटर खोलें

इस पर जाएँ Workflows अपने workspace में और वह workflow खोलें जिसमें आप events जोड़ना चाहते हैं।

2

Vision Event Block जोड़ें

block catalog में "Vision Event" खोजें और इसे अपने workflow में जोड़ें।

3

इनपुट कनेक्ट करें

image input और model prediction outputs को Vision Event block से कनेक्ट करें।

4

Use Case कॉन्फ़िगर करें

Use Case का नाम सेट करें (useCaseId)। आप upstream blocks से custom metadata भी map कर सकते हैं। एक बार Use Case चुन लेने के बाद, नीचे dropdown में "Open in Vision Events" पर क्लिक करें ताकि उस Use Case के events page पर एक नए tab में जाएँ।

5

वर्कफ़्लो तैनात करें

अपने workflow को deploy या update करें। हर बार workflow चलने पर events अपने-आप बनते हैं।

Workflow block image upload और event creation को एक ही step में संभालता है।

REST API

जो custom integrations या pipelines Workflows का उपयोग नहीं करतीं, उनके लिए आप events सीधे REST API के माध्यम से भेज सकते हैं। complete request और response schemas के लिए, देखें Vision Events API संदर्भ.

प्रमाणीकरण

सभी write endpoints के लिए एक API key चाहिए जिसमें visionEvents.write या device.update scope हो। API key को Bearer token के रूप में पास करें:

Authorization: Bearer YOUR_API_KEY

एंड-टू-एंड उदाहरण: इमेज अपलोड करें + इवेंट बनाएं

इवेंट भेजने से पहले आपको एक Use Case बनाना होगा। किसी useCaseId जो मौजूद नहीं है, उसे संदर्भित करने वाले events अस्वीकार कर दिए जाएंगे।

API के माध्यम से events भेजते समय, पहले आप image upload करते हैं, फिर uploaded image को संदर्भित करते हुए event बनाते हैं।

चरण 1: इमेज अपलोड करें

curl -X POST "https://api.roboflow.com/vision-events/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@inspection_photo.jpg"

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

{
  "success": true,
  "sourceId": "abc123def456",
  "url": "https://storage.googleapis.com/your-workspace/abc123def456/original.jpg"
}

चरण 2: uploaded image को संदर्भित करते हुए event बनाएं

curl -X POST "https://api.roboflow.com/vision-events" \
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "eventType": "quality_check",
    "useCaseId": "assembly-line-qa",
    "timestamp": "2026-03-30T14:30:00.000Z",
    "deviceId": "factory-cam-01",
    "streamId": "line-3",
    "images": [
      {
        "sourceId": "abc123def456",
        "objectDetections": [
          {
            "class": "defect",
            "x": 320,
            "y": 240,
            "width": 50,
            "height": 40,
            "confidence": 0.95
          }
        ]
      }
    ],
    "eventData": {
      "result": "fail"
    },
    "customMetadata": {
      "line_id": "line-3",
      "shift": "morning",
      "part_number": "PN-4421"
    }
  }'

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

{
  "eventId": "evt-789ghi",
  "created": true
}

बैच में इवेंट बनाएं

बैच endpoint का उपयोग करके एक ही request में अधिकतम 100 events भेजें:

curl -X POST "https://api.roboflow.com/vision-events/batch" \
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "events": [
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "pass" },
        "customMetadata": { "line_id": "line-1" }
      },
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "fail" },
        "customMetadata": { "line_id": "line-2" }
      }
    ]
  }'

प्रति batch request अधिकतम 100 events।

एज डिवाइस बैकअप

ऐसे enterprise deployments के लिए जहाँ connectivity बीच-बीच में बाधित हो सकती है, edge device events को स्थानीय रूप से संग्रहीत करता है और connectivity बहाल होने पर उन्हें Roboflow से sync करता है।

Edge Device Backup के लिए Deployment Manager आवश्यक है। देखें Deployment Manager दस्तावेज़ सेटअप निर्देशों के लिए।

Vision Events backup सक्षम करने के लिए:

1. खोलें Deployment Manager अपने workspace में

2. कॉन्फ़िगर करने के लिए डिवाइस चुनें

3. सक्षम करें Vision Events Backup डिवाइस की इवेंट स्टोर कॉन्फ़िगरेशन

4. events डिवाइस पर स्थानीय event store में लिखे जाते हैं

5. जब डिवाइस फिर से कनेक्ट होता है, तो events अपने-आप Roboflow से sync हो जाते हैं

sync पूरा होने के बाद events Vision Events dashboard में दिखाई देते हैं।