> 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/roboflow-cloud/cloud-streaming/run-a-workflow.md).

# एक Workflow चलाएँ

Cloud Streaming स्रोत पर किसी Workflow का पूर्वावलोकन, डिप्लॉय, अपडेट और रोकना, स्पष्ट वर्शन और sink व्यवहार के साथ।

किसी जुड़े हुए स्रोत पर [Workflow चलाएँ](https://docs.roboflow.com/deployment/hi/roboflow-cloud/cloud-streaming/connect-a-source.md) ताकि लाइव वीडियो को पूर्वानुमानों, एनोटेट किए गए वीडियो और आगे की कार्रवाइयों में बदला जा सके। ड्राफ़्ट का परीक्षण करते समय सीमित अवधि वाला प्रीव्यू चुनें, या जब आप चाहते हों कि दर्शक के बिना भी प्रोसेसिंग जारी रहे, तो डिप्लॉयमेंट चुनें।

पहली बार पूरा रन करने के लिए [क्विकस्टार्ट](https://docs.roboflow.com/deployment/hi/roboflow-cloud/cloud-streaming/quickstart.md) का उपयोग करें। प्रीव्यू और डिप्लॉयमेंट, दोनों की प्रोसेसिंग में क्रेडिट खर्च होते हैं।

## वेब ऐप

### ड्राफ़्ट का प्रीव्यू देखें

अपना सेव किया हुआ Workflow खोलें, "Run" पर क्लिक करें और कोई जुड़ी हुई स्ट्रीम या अस्थायी वेबकैम/फ़ोन सेशन चुनें। "Enable Sinks" डिफ़ॉल्ट रूप से चालू होता है: जब परीक्षण के दौरान बाहरी सिस्टम में डेटा नहीं लिखना हो, तो इसे बंद कर दें।

<figure><img src="https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-d4d9281f1fbd8ab679e4a32957c3782414869078%2Fcloud-streaming-shot05-editor-preview.png?alt=media" alt="Workflow editor with a stream preview and JSON output."><figcaption><p>Run, एडिटर में Workflow का परीक्षण करता है और वीडियो तथा संरचित आउटपुट दिखाता है।</p></figcaption></figure>

### प्रकाशित Workflow डिप्लॉय करें

"Deployments" खोलें, फिर "Cloud Streaming" चुनें; स्रोत चुनकर "Run a Workflow" चुनें। या Workflow एडिटर में "Deploy" पर क्लिक करें और "Cloud Streaming" चुनें। ज़रूरी "Workflow Inputs" भरें। प्रोसेसिंग शुरू होने पर आपके बदले हुए मान उस स्रोत के लिए सेव हो जाते हैं और अगली बार उस पर Workflow चलाने पर फिर लोड होते हैं। Workflow के डिफ़ॉल्ट मान को दोबारा इस्तेमाल करने के लिए "Reset to Workflow Default" पर क्लिक करें। एनोटेट किया गया वीडियो पाने के लिए "Visual Preview Output" के अंतर्गत इमेज आउटपुट चुनें; केवल JSON वाला Workflow इसके बिना चलता है, लेकिन वीडियो नहीं बनाता। अनुमान की समीक्षा करें और "Start Processing" पर क्लिक करें।

लगातार 30 सेकंड तक प्रोसेसिंग होने के बाद Automatic Recovery चालू हो जाता है। अगर किसी डिप्लॉयमेंट में "Enable Automatic Recovery" दिखे, तो उस पर क्लिक करें।

<figure><img src="https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-a2c37f334171d61022f87f911199aec658af4e62%2Fcloud-streaming-shot05-use-workflow.png?alt=media" alt="Use Workflow dialog with Cloud Streaming selected and available sources."><figcaption><p>Agent में, "Use" से Cloud Streaming डिप्लॉयमेंट के विकल्प खुलते हैं। दिखाई गई कीमतें केवल उदाहरण के लिए हैं।</p></figcaption></figure>

अनुमान प्रति घंटे की दर है, कुल राशि नहीं। "Start Processing" स्रोत पर मौजूद अन्य डिप्लॉयमेंट के साथ-साथ चलता है।

### चलते हुए प्रीव्यू को डिप्लॉय करें

चलता हुआ प्रीव्यू चुनें और "Deploy Stream" पर क्लिक करें। अगर कैमरे पर अन्य डिप्लॉयमेंट चल रहे हों, तो उन्हें रोकने के लिए "Replace" या सभी को जारी रखने के लिए "Keep All" पर क्लिक करें। प्रीव्यू बिना रीस्टार्ट हुए डिप्लॉयमेंट बन जाता है। देखें [प्रमोशन](#promotion).

<figure><img src="https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-a3261a56bb282891bf8d6955842b2a64f934cf55%2Fcloud-streaming-shot06-promote-preview.png?alt=media" alt="Deploy Stream confirmation explaining continued billing and preserved Workflow settings."><figcaption><p>डिप्लॉयमेंट की पुष्टि करने से पहले लगातार प्रोसेसिंग और बिलिंग की समीक्षा करें। दिखाई गई कीमतें केवल उदाहरण के लिए हैं।</p></figcaption></figure>

### Workflow में किए गए बदलाव लागू करें

Workflow प्रकाशित करने से चल रहे डिप्लॉयमेंट में बदलाव नहीं होता। इसे प्रकाशित करें, फिर डिप्लॉयमेंट रीस्टार्ट करें; या इसे रोककर नया रन शुरू करें। देखें [रीस्टार्ट का व्यवहार](#restarts) और [रीस्टार्ट के नियंत्रण](https://docs.roboflow.com/deployment/hi/roboflow-cloud/cloud-streaming/manage-and-monitor.md#restart-processing).

### रन रोकें या बदलें

"Stop" पर क्लिक करें, फिर पुष्टि करने के लिए "Stop processing" पर क्लिक करें। प्लेयर बंद करने या पेज छोड़ने से डिप्लॉयमेंट या उसके शुल्क बंद नहीं होते।

## Workflow का जीवनचक्र

प्रीव्यू में देखने के दौरान परीक्षण के लिए ड्राफ़्ट चलता है। डिप्लॉयमेंट में प्रकाशित Workflow लगातार चलता है और दर्शक की ज़रूरत नहीं होती। नीचे दी गई हर कार्रवाई तय करती है कि Workflow का कौन-सा संस्करण चलेगा और ट्रैकर तथा काउंटर आगे भी बने रहेंगे या नहीं।

<table data-search="false"><thead><tr><th>कार्रवाई</th><th>Workflow संस्करण</th><th>स्थिति और सिंक</th></tr></thead><tbody><tr><td>प्रीव्यू</td><td>आपका ड्राफ़्ट, जैसा वह प्रीव्यू शुरू होने के समय था</td><td>अलग से चलने वाला छोटा रन। सिंक, "Enable Sinks" सेटिंग के अनुसार काम करते हैं (डिफ़ॉल्ट रूप से चालू)।</td></tr><tr><td>डिप्लॉय करें</td><td>डिप्लॉयमेंट शुरू होने के समय का प्रकाशित संस्करण</td><td>ट्रैकर और काउंटर नए सिरे से शुरू होते हैं। प्रकाशित सिंक सेटिंग का उपयोग होता है।</td></tr><tr><td>Deploy Stream (प्रीव्यू को डिप्लॉय करें)</td><td>ठीक वही चलता हुआ प्रीव्यू</td><td>वही रन और स्थिति। बंद किए गए सिंक बंद ही रहते हैं। कुछ भी प्रकाशित या रीस्टार्ट नहीं होता।</td></tr><tr><td>रीस्टार्ट</td><td>नवीनतम प्रकाशित संस्करण</td><td>समान इनपुट के साथ नया रन। ट्रैकर और काउंटर रीसेट हो जाते हैं।</td></tr><tr><td>कैमरा रन के पहले 30 सेकंड में रीस्टार्ट करें</td><td>परीक्षण के तहत संस्करण</td><td>नया रन। किए गए बदलावों का परीक्षण करने के लिए नया रन शुरू करें।</td></tr><tr><td>बड़े GPU पर फिर से प्रयास करें</td><td>वह संस्करण जिसकी मेमोरी समाप्त हो गई</td><td>बड़े GPU पर नया रन। ट्रैकर और काउंटर रीसेट हो जाते हैं।</td></tr><tr><td>स्वचालित रिकवरी</td><td>डिप्लॉयमेंट का संस्करण</td><td>नया रन। ट्रैकर और काउंटर रीसेट हो गए। रिकवरी प्रतीक्षा या विराम कर सकती है।</td></tr></tbody></table>

### प्रीव्यू

प्रीव्यू ड्राफ़्ट को प्रकाशित किए बिना चलाता है और सोर्स पर मौजूद किसी भी डिप्लॉयमेंट के साथ-साथ चलता है। आख़िरी दर्शक के जाने के 2 मिनट बाद (कोई न देख रहा हो तो 10 मिनट बाद), या एक घंटे बाद यह रुक जाता है। वेबकैम और फ़ोन के प्रीव्यू ब्राउज़र का कनेक्शन टूटने पर भी समाप्त हो जाते हैं।

### डिप्लॉयमेंट

डिप्लॉयमेंट शुरू होने के समय प्रकाशित संस्करण चलाता है। बाद में किए गए बदलाव केवल रीस्टार्ट करने के बाद लागू होते हैं।

### प्रमोशन

प्रमोशन किसी चल रहे प्रीव्यू को बिना रीस्टार्ट किए डिप्लॉयमेंट में बदल देता है। इसमें चल रहा Workflow, इनपुट, GPU, स्थिति और sink सेटिंग्स बरकरार रहती हैं। यह ड्राफ़्ट प्रकाशित नहीं करता और बंद किए गए sink को फिर से चालू नहीं करता।

आप किसी प्रीव्यू को तभी प्रमोट कर सकते हैं, जब ये सभी शर्तें पूरी हों:

* आपने इसे ऐप में शुरू किया हो और आपके पास "Manage Source Video" की अनुमति हो।
* यह वेबकैम या फ़ोन सेशन पर नहीं, बल्कि कैमरे पर सेव किया गया Workflow चलाता हो।
* यह चल रहा हो और इस समय कोई स्टॉप, रीस्टार्ट या GPU बदलाव न हो रहा हो।

### रीस्टार्ट

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

दो स्थितियों में पुराना स्नैपशॉट बना रहता है:

* कैमरा रन के पहले 30 सेकंड के भीतर रीस्टार्ट करने पर परीक्षणाधीन संस्करण बना रहता है।
* GPU मेमोरी की विफलता के बाद बड़े GPU पर दोबारा प्रयास करने पर विफल हुआ संस्करण बना रहता है। ऐप रन अपने आप दोबारा प्रयास करते हैं; API जॉब में "Retry on" बटन दिखता है।

### रोकना

जॉब रोकना, अस्थायी सेशन समाप्त करना, कैमरा बंद करना और सोर्स हटाना—ये अलग-अलग कार्रवाइयाँ हैं। प्रोसेसिंग समाप्त करने के लिए जॉब रोकें। प्लेयर बंद करने, पेज छोड़ने, दर्शक का कनेक्शन टूटने, कैमरा अनप्लग करने या उसके पब्लिशर को रोकने से डिप्लॉयमेंट या उससे जुड़े शुल्क नहीं रुकते: रिकवरी चालू होने पर सक्षम डिप्लॉयमेंट प्रतीक्षा करता है और वीडियो वापस आने पर फिर शुरू हो जाता है। पुराने प्रीव्यू की स्वचालित सफ़ाई से प्रमोट किया गया डिप्लॉयमेंट नहीं रुकता। कैमरा हटाना या निकालना उसके Workflow को अपडेट करने का तरीका नहीं है।

"Deploy Stream" और Agent पूछते हैं कि क्या अन्य डिप्लॉयमेंट बदलने हैं। "Start Processing" हमेशा उनके साथ-साथ चलता है।

## Roboflow Agent

Agent से कोई सोर्स चुनने और अपने Workflow के ड्राफ़्ट का प्रीव्यू चलाने को कहें। यह लाइव परिणाम देख सकता है और सक्रिय डिप्लॉयमेंट बदले बिना आपको उसमें सुधार करने में मदद कर सकता है।

<figure><img src="https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1d699f47676beb99be6882b70d4daba5fe79b593%2Fcloud-streaming-shot06-agent-preview.png?alt=media" alt="Agent stream preview with detected people and Deploy Stream above the composer."><figcaption><p>"Deploy Stream" चुनने से पहले प्रीव्यू देखें।</p></figcaption></figure>

प्रीव्यू चालू रखने के लिए Agent से इसे डिप्लॉय करने को कहें, या चैट बॉक्स के ऊपर "Deploy Stream" पर क्लिक करें।

कोई अलग Workflow शुरू करने के लिए, उसे कैमरे पर डिप्लॉय करने को कहें। Agent के बदलाव किसी डिप्लॉयमेंट पर लागू करने के लिए, उसे अपडेट करने को कहें: Agent ड्राफ़्ट प्रकाशित करेगा और प्रोसेसिंग रीस्टार्ट करेगा।

रोकने का अनुरोध करते समय स्पष्ट रहें: उस डिप्लॉयमेंट का नाम बताएँ जिसे रोकना है। प्रीव्यू डिस्कनेक्ट करने का अनुरोध डिप्लॉयमेंट को नहीं रोकता।

## HTTP API

ऐसी API key से जॉब शुरू करें जिसके पास `video-inference-job:create`, `workflow:read`और `model:infer`की अनुमतियाँ हों। पढ़ने के लिए `video-inference-job:read`चाहिए। देखें [API प्रमाणीकरण](https://docs.roboflow.com/reference/platform/rest-api/authenticate-with-the-rest-api).

API में रीस्टार्ट, प्रमोशन या कीमत की स्वीकृति से जुड़ी कार्रवाइयाँ उपलब्ध नहीं हैं: इनके लिए Web App का उपयोग करें।

### Workflow के इनपुट और आउटपुट देखें

जॉब शुरू करने से पहले देखें कि आपके सेव किए गए Workflow को किन चीज़ों की ज़रूरत है और वह क्या लौटाता है। एनोटेटेड वीडियो पाने के लिए ऐसा आउटपुट इस्तेमाल करें जिसमें `isImage: true` हो, उसे `imageOutput` के रूप में इस्तेमाल करें।

{% openapi src="/files/b0e522ab41386af273dcd678aa1bfa8c7468d95d" path="/{workspace}/video-sources/v1/workflow-interface" method="get" %}
[cloud-streaming.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### जॉब शुरू करें

हर जॉब के लिए नया `Idempotency-Key` भेजें और इसका दोबारा उपयोग केवल उसी अनुरोध को फिर से आज़माने के लिए करें। API प्रीव्यू Workflow के sink बंद नहीं करते। API जॉब आपके भेजे हुए `processorSize` का उपयोग करते हैं, या Small का। Workflow के आधार पर जॉब का आकार तय करने और मेमोरी त्रुटि के बाद उसे बड़े GPU पर ले जाने के लिए, यह भेजें: `autoSize: true` के बिना `processorSize`. जॉब Web App में स्रोत के लिए सहेजे गए Workflow इनपुट मानों का भी उपयोग करते हैं, जब तक कि आप अन्य मान न भेजें।

{% openapi src="/files/b0e522ab41386af273dcd678aa1bfa8c7468d95d" path="/{workspace}/video-sources/v1/{sourceId}/jobs" method="post" %}
[cloud-streaming.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### जॉब पढ़ें और प्रोसेसिंग पूरी होने तक प्रतीक्षा करें

बनाया गया जॉब अभी प्रोसेस नहीं हो रहा होता। उसके चलने या समाप्त होने तक उसे पढ़ते रहें, और दूसरा जॉब शुरू करने के बजाय उसकी त्रुटि जाँचें।

{% openapi src="/files/b0e522ab41386af273dcd678aa1bfa8c7468d95d" path="/{workspace}/video-jobs/v1" method="get" %}
[cloud-streaming.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

{% openapi src="/files/b0e522ab41386af273dcd678aa1bfa8c7468d95d" path="/{workspace}/video-jobs/v1/{jobId}" method="get" %}
[cloud-streaming.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

जब यह चल रहा हो, [वीडियो और परिणामों का उपयोग करें](https://docs.roboflow.com/deployment/hi/roboflow-cloud/cloud-streaming/consume-results.md#http-api). `processingPrice` वर्तमान प्रति घंटा दर है, आपका कुल खर्च नहीं। लाइव आउटपुट सहेजा नहीं जाता।

### अस्थायी पूर्वावलोकन चालू रखें

वेबकैम या फ़ोन का पूर्वावलोकन तब रिन्यू करना बंद करने के 2 मिनट बाद रुक जाता है। इसे हर 30 सेकंड में रिन्यू करें। वीडियो चलाते रहने के लिए, इस्तेमाल करें [देखें](https://docs.roboflow.com/deployment/hi/roboflow-cloud/cloud-streaming/consume-results.md#watch-live-output).

{% openapi src="/files/b0e522ab41386af273dcd678aa1bfa8c7468d95d" path="/{workspace}/video-jobs/v1/{jobId}/hold-preview" method="post" %}
[cloud-streaming.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### जॉब रोकें

जॉब रद्द करें, फिर उसके समाप्त होने तक उसे पढ़ते रहें। रद्द की गई डिप्लॉयमेंट बहाल नहीं होती।

{% openapi src="/files/b0e522ab41386af273dcd678aa1bfa8c7468d95d" path="/{workspace}/video-jobs/v1/{jobId}/cancel" method="post" %}
[cloud-streaming.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

अस्थायी कैमरे के लिए, यह भी [उसका सेशन रोकें](https://docs.roboflow.com/deployment/hi/roboflow-cloud/cloud-streaming/connect-a-source.md#stop-a-temporary-session) जब आप सिर्फ़ एक Workflow रन के बजाय प्रकाशन समाप्त करना चाहें।
