ईमेल सूचना

ईमेल के माध्यम से सूचना भेजें।

v2

यह ईमेल सूचना ब्लॉक उपयोगकर्ताओं को वर्कफ़्लो के हिस्से के रूप में ईमेल सूचनाएँ भेजने की अनुमति देता है।

यह ब्लॉक कैसे काम करता है

ईमेल प्रदाता विकल्प

यह ब्लॉक एक ड्रॉपडाउन चयनकर्ता के माध्यम से दो ईमेल डिलीवरी विधियों का समर्थन करता है:

1. Roboflow प्रबंधित API कुंजी (डिफ़ॉल्ट) - किसी SMTP कॉन्फ़िगरेशन की आवश्यकता नहीं है। ईमेल Roboflow की प्रॉक्सी सेवा के माध्यम से भेजे जाते हैं:

   • सरल सेटअप - बस विषय, संदेश और प्राप्तकर्ता प्रदान करें

   • सुरक्षित - प्रमाणीकरण के लिए आपकी वर्कफ़्लो API कुंजी का उपयोग किया जाता है

   • SMTP सर्वर की आवश्यकता नहीं

2. कस्टम SMTP - अपना स्वयं का SMTP सर्वर उपयोग करें:

   • ईमेल डिलीवरी पर पूर्ण नियंत्रण

   • SMTP सर्वर कॉन्फ़िगरेशन (होस्ट, पोर्ट, क्रेडेंशियल) की आवश्यकता है

   • CC और BCC प्राप्तकर्ताओं का समर्थन करता है

अनुकूलन योग्य ईमेल सामग्री

• विषय: ईमेल की विषय पंक्ति निर्धारित करने के लिए विषय फ़ील्ड सेट करें।

• संदेश: ईमेल की मुख्य सामग्री लिखने के लिए संदेश फ़ील्ड का उपयोग करें। संदेश को वर्कफ़्लो रन के दौरान उत्पन्न डेटा के साथ पैरामीटराइज़ किया जा सकता है। देखें गतिशील पैरामीटर अनुभाग।

• प्राप्तकर्ता (To, CC, BCC): ईमेल किसे प्राप्त होगा, यह निर्धारित करने के लिए उपयोग करें receiver_email, cc_receiver_email, और bcc_receiver_email गुण। आप एक एकल ईमेल या सूची दर्ज कर सकते हैं।

गतिशील पैरामीटर

संदेश की सामग्री को वर्कफ़्लो निष्पादन परिणामों के साथ पैरामीटराइज़ किया जा सकता है। गतिशील पैरामीटरों का उपयोग करके उदाहरण संदेश देखें:

message = "यह एक उदाहरण सूचना है। अनुमानित वर्ग: {{ $parameters.predicted_classes }}"

संदेश पैरामीटर Workflows Execution Engine द्वारा उचित डेटा चयनकर्ता सेट करके प्रदान किए जाते हैं message_parameters फ़ील्ड में, उदाहरण के लिए:

message_parameters = {
    "predicted_classes": "$steps.model.predictions"
}

डेटा का चयन करना ही एकमात्र विकल्प नहीं है - डेटा को ब्लॉक में प्रोसेस भी किया जा सकता है। नीचे दिए गए उदाहरण में हम अनुमानित वर्गों के नाम निकालना चाहते हैं। हम रूपांतरण लागू कर सकते हैं प्रत्येक पैरामीटर के लिए सेट करके message_parameters_operations:

message_parameters_operations = {
    "predictions": [
        {"type": "DetectionsPropertyExtract", "property_name": "class_name"}
    ]
}

परिणामस्वरूप, भेजे जाने वाले ईमेल में आप यह अपेक्षा कर सकते हैं:

यह एक उदाहरण सूचना है। अनुमानित वर्ग: ["class_a", "class_b"].

कस्टम SMTP सर्वर का उपयोग

अपना स्वयं का SMTP सर्वर उपयोग करने के लिए, email_provider ड्रॉपडाउन से "Custom SMTP" चुनें और निम्नलिखित पैरामीटर कॉन्फ़िगर करें:

• smtp_server - उपयोग किए जाने वाले SMTP सर्वर का होस्टनाम

• sender_email - प्रेषक के रूप में उपयोग किया जाने वाला ईमेल खाता

• sender_email_password - प्रेषक ईमेल खाते का पासवर्ड

• smtp_port - SMTP सेवा का पोर्ट - डिफ़ॉल्ट रूप से 465

ब्लॉक लागू करता है SMTP पर SSL।

कस्टम SMTP सर्वर उपयोग करने का सामान्य परिदृश्य Google SMTP सर्वर के माध्यम से ईमेल भेजना है। देखें Google ट्यूटोरियल ब्लॉक को सही ढंग से कॉन्फ़िगर करने के लिए।

यदि 2-चरण सत्यापन चालू है, तो GMAIL पासवर्ड काम नहीं करेगा

ईमेल सेवा प्रदाता के रूप में कस्टम SMTP सर्वर चुनने वाले GMAIL उपयोगकर्ताओं को कॉन्फ़िगर करना होगा एप्लिकेशन पासवर्ड 2-चरण सत्यापन-संरक्षित खाते के साथ समस्याओं से बचने के लिए। ध्यान दें कि एप्लिकेशन पासवर्ड को सुरक्षित रखा जाना चाहिए - हम पासवर्ड को वर्कफ़्लो इनपुट में भेजने और इसे कॉलर द्वारा हर बार प्रदान करने की अनुशंसा करते हैं, ताकि इसे वर्कफ़्लो परिभाषा में संग्रहीत करने से बचा जा सके।

कूलडाउन

ब्लॉक cooldown_seconds (जो डिफ़ॉल्ट रूप से 5 सेकंड) अप्रत्याशित सूचना बर्स्ट को रोकने के लिए स्वीकार करता है। कृपया अपनी आवश्यकता के अनुसार इसे समायोजित करें, 0 कूलडाउन न होने का संकेत दें।

कूलडाउन अवधि के दौरान, चरण के लगातार रन से throttling_status आउटपुट True पर सेट किया जाएगा और कोई सूचना नहीं भेजी जाएगी।

कूलडाउन सीमाएँ

कूलडाउन का वर्तमान कार्यान्वयन केवल वीडियो प्रोसेसिंग तक सीमित है - इस ब्लॉक का उपयोग उस वर्कफ़्लो के संदर्भ में करना जो HTTP सेवा (Roboflow Hosted API, Dedicated Deployment या self-hosted inference सर्वर) के पीछे चलाया जाता है, HTTP अनुरोधों के प्रसंस्करण पर कोई प्रभाव नहीं डालेगा।

अटैचमेंट

आप अपने ईमेल के साथ भेजे जाने वाले अटैचमेंट फ़ाइलें निर्दिष्ट कर सकते हैं। अटैचमेंट रनटाइम में समर्पित ब्लॉकों द्वारा या छवि आउटपुट से उत्पन्न किए जा सकते हैं।

समर्थित अटैचमेंट प्रकार:

• CSV/टेक्स्ट फ़ाइलें: जैसे ब्लॉकों से CSV फ़ॉर्मेटर

• छवियाँ: विज़ुअलाइज़ेशन ब्लॉकों से कोई भी छवि आउटपुट (स्वचालित रूप से JPEG में परिवर्तित)

• द्विआधारी डेटा: संगत ब्लॉकों से कोई भी bytes आउटपुट

अटैचमेंट शामिल करने के लिए, अटैचमेंट फ़ाइलनाम को कुंजी के रूप में प्रदान करें और ब्लॉक आउटपुट का संदर्भ दें:

attachments = {
    "report.csv": "$steps.csv_formatter.csv_content",
    "detection.jpg": "$steps.bounding_box_visualization.image"
}

नोट: छवि अटैचमेंट स्वचालित रूप से JPEG प्रारूप में परिवर्तित हो जाते हैं। यदि फ़ाइलनाम में .jpg या .jpeg एक्सटेंशन शामिल नहीं है, तो इसे स्वचालित रूप से जोड़ दिया जाएगा।

असमकालिक निष्पादन

कॉन्फ़िगर करें fire_and_forget गुण। यदि आप चाहते हैं कि ईमेल बैकग्राउंड में भेजा जाए, जिससे वर्कफ़्लो ईमेल भेजे जाने की प्रतीक्षा किए बिना आगे बढ़ सके, तो इसे True पर सेट करें। इस स्थिति में आप error_status आउटपुट पर निर्भर नहीं रह पाएंगे, जो हमेशा Falseपर सेट रहेगा, इसलिए हम सेट करने की अनुशंसा करते हैं fire_and_forget=False डिबगिंग उद्देश्यों के लिए.

रनटाइम पैरामीटर के आधार पर सूचनाएँ अक्षम करना

कभी-कभी ईमेल नोटिफ़ायर ब्लॉक को मैन्युअल रूप से अक्षम करना सुविधाजनक होगा। यह disable_sink फ़्लैग को वर्कफ़्लो इनपुट का संदर्भ रखने के लिए सेट करके संभव है। ऐसे सेटअप के साथ, कॉलर आवश्यक होने पर सहमत इनपुट पैरामीटर भेजकर सिंक को अक्षम कर सकेगा।

सामान्य उपयोग के मामले

• इस ब्लॉक का उपयोग [ब्लॉक प्रकार के आधार पर उद्देश्य] के लिए करें

अन्य ब्लॉक्स से कनेक्ट करना

इस ब्लॉक के आउटपुट आपके वर्कफ़्लो में अन्य ब्लॉकों से जोड़े जा सकते हैं।

प्रकार पहचानकर्ता

स्टेप में निम्नलिखित पहचानकर्ता का उपयोग करें "type" फ़ील्ड: roboflow_core/email_notification@v2 अपने वर्कफ़्लो में ब्लॉक को एक स्टेप के रूप में जोड़ने के लिए।

गुण

नाम	प्रकार	विवरण	संदर्भ
name	str	इस स्टेप के लिए एक विशिष्ट पहचानकर्ता दर्ज करें..	❌
email_provider	str	ईमेल डिलीवरी विधि चुनें: Roboflow की प्रबंधित सेवा का उपयोग करें या अपना स्वयं का SMTP सर्वर कॉन्फ़िगर करें..	❌
subject	str	संदेश का विषय..	❌
receiver_email	Union[List[str], str]	गंतव्य ईमेल पता..	✅
message	str	भेजी जाने वाली संदेश सामग्री..	❌
message_parameters	Dict[str, Union[bool, float, int, str]]	संदेश के भीतर उपयोग किया जाने वाला डेटा..	✅
message_parameters_operations	Dict[str, List[Union[ClassificationPropertyExtract, ConvertDictionaryToJSON, ConvertImageToBase64, ConvertImageToJPEG, DetectionsFilter, DetectionsOffset, DetectionsPropertyExtract, DetectionsRename, DetectionsSelection, DetectionsShift, DetectionsToDictionary, Divide, ExtractDetectionProperty, ExtractFrameMetadata, ExtractImageProperty, LookupTable, Multiply, NumberRound, NumericSequenceAggregate, PickDetectionsByParentClass, RandomNumber, SequenceAggregate, SequenceApply, SequenceElementsCount, SequenceLength, SequenceMap, SortDetections, StringMatches, StringSubSequence, StringToLowerCase, StringToUpperCase, TimestampToISOFormat, ToBoolean, ToNumber, ToString]]]	संदेश पैरामीटरों पर किए जाने वाले पूर्व-प्रसंस्करण ऑपरेशन..	❌
sender_email	str	संदेश भेजने के लिए उपयोग किया जाने वाला ईमेल..	✅
smtp_server	str	उपयोग किया जाने वाला कस्टम SMTP सर्वर..	✅
sender_email_password	str	SMTP सर्वर के साथ प्रमाणीकरण करते समय उपयोग किया जाने वाला प्रेषक ईमेल पासवर्ड..	✅
cc_receiver_email	Optional[List[str], str]	CC ईमेल पता..	✅
bcc_receiver_email	Optional[List[str], str]	BCC ईमेल पता..	✅
smtp_port	int	SMTP सर्वर पोर्ट..	❌
fire_and_forget	bool	तेज़ वर्कफ़्लोज़ के लिए ब्लॉक को असमकालिक रूप से (True) या डिबगिंग और त्रुटि प्रबंधन के लिए समकालिक रूप से (False) चलाने वाला बूलियन फ़्लैग..	✅
disable_sink	bool	ब्लॉक निष्पादन को अक्षम करने वाला बूलियन फ़्लैग..	✅
cooldown_seconds	int	फॉलो-अप सूचना भेजे जाने तक सेकंडों की संख्या. .	✅

यह संदर्भ स्तंभ यह इंगित करता है कि संपत्ति को वर्कफ़्लो रनटाइम में उपलब्ध गतिशील मानों के साथ पैरामीटराइज़ किया जा सकता है वर्कफ़्लो रनटाइम। देखें बाइंडिंग्स अधिक जानकारी के लिए।

रनटाइम संगतता

सॉफ्ट - रनटाइम hosted_serverless, dedicated_deployment; निष्पादन दूरस्थ : Cooldown / rate-limit timer process memory में संग्रहीत होता है। stateless या multi-replica HTTP runtimes पर remote step execution के साथ प्रत्येक अनुरोध को एक नया worker मिलता है, इसलिए cooldown throttling नहीं करता। Cooldown केवल persistent WebRTC session में local step execution के साथ दस्तावेज़ के अनुसार काम करता है।

इनपुट और आउटपुट बाइंडिंग्स

उपलब्ध कनेक्शन उसके बाइंडिंग प्रकारों पर निर्भर करते हैं। देखें कि कौन-से बाइंडिंग प्रकार ईमेल सूचना संस्करण v2 है।

इनपुट और आउटपुट बाइंडिंग्स

• इनपुट

  • receiver_email (Union[list_of_values, string]): गंतव्य ईमेल पता..

  • message_parameters (*): संदेश के भीतर उपयोग किया जाने वाला डेटा..

  • sender_email (string): संदेश भेजने के लिए उपयोग किया जाने वाला ईमेल..

  • smtp_server (string): उपयोग किया जाने वाला कस्टम SMTP सर्वर..

  • sender_email_password (Union[secret, string]): SMTP सर्वर के साथ प्रमाणीकरण करते समय उपयोग किया जाने वाला प्रेषक ईमेल पासवर्ड..

  • cc_receiver_email (Union[list_of_values, string]): CC ईमेल पता..

  • bcc_receiver_email (Union[list_of_values, string]): BCC ईमेल पता..

  • attachments (Union[bytes, छवि, string]): अटैचमेंट।

  • fire_and_forget (boolean): तेज़ वर्कफ़्लोज़ के लिए ब्लॉक को असमकालिक रूप से (True) या डिबगिंग और त्रुटि प्रबंधन के लिए समकालिक रूप से (False) चलाने वाला बूलियन फ़्लैग..

  • disable_sink (boolean): ब्लॉक निष्पादन को अक्षम करने वाला बूलियन फ़्लैग..

  • cooldown_seconds (पूर्णांक): फॉलो-अप सूचना भेजे जाने तक सेकंडों की संख्या. .

• आउटपुट

  • error_status (boolean): बूलियन फ़्लैग.

  • throttling_status (boolean): बूलियन फ़्लैग.

  • message (string): स्ट्रिंग मान.

उदाहरण JSON परिभाषा

{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/email_notification@v2",
	    "email_provider": "Roboflow प्रबंधित API कुंजी",
	    "subject": "वर्कफ़्लो अलर्ट",
	    "receiver_email": "[e-mail]",
	    "message": "पिछले 5 मिनट के दौरान {{ $parameters.num_instances }} उदाहरणों का पता चला",
	    "message_parameters": {
	        "predictions": "$steps.model.predictions",
	        "reference": "$inputs.reference_class_names"
	    },
	    "message_parameters_operations": {
	        "predictions": [
	            {
	                "property_name": "class_name",
	                "type": "DetectionsPropertyExtract"
	            }
	        ]
	    },
	    "sender_email": "[e-mail]",
	    "smtp_server": "$inputs.smtp_server",
	    "sender_email_password": "$inputs.email_password",
	    "cc_receiver_email": "[e-mail]",
	    "bcc_receiver_email": "[e-mail]",
	    "smtp_port": 465,
	    "attachments": {
	        "report.cvs": "$steps.csv_formatter.csv_content"
	    },
	    "fire_and_forget": "$inputs.fire_and_forget",
	    "disable_sink": false,
	    "cooldown_seconds": "$inputs.cooldown_seconds"
	}

v1

SMTP सर्वर के माध्यम से ईमेल सूचनाएँ भेजें, जिसमें अनुकूलन योग्य विषय, गतिशील वर्कफ़्लो डेटा पैरामीटरों के साथ संदेश सामग्री, प्राप्तकर्ता सूचियाँ (To, CC, BCC), फ़ाइल अटैचमेंट, कूलडाउन थ्रॉटलिंग, और अलर्टिंग, रिपोर्टिंग तथा संचार वर्कफ़्लोज़ के लिए वैकल्पिक असमकालिक बैकग्राउंड निष्पादन शामिल हैं।

यह ब्लॉक कैसे काम करता है

यह ब्लॉक SMTP सर्वर के माध्यम से ईमेल सूचनाएँ भेजता है, और वर्कफ़्लो निष्पादन परिणामों को ईमेल सामग्री में एकीकृत करता है। ब्लॉक:

1. जांचता है कि disable_sink फ़्लैग के माध्यम से सिंक अक्षम है या नहीं (यदि अक्षम है, तो बिना भेजे तुरंत लौटता है)

2. कूलडाउन अवधि को मान्य करता है (यदि सक्षम है, तो cooldown_seconds पिछले भेजे गए ईमेल के भीतर सूचनाओं को थ्रॉटल करता है, और throttling status लौटाता है)

3. गतिशील पैरामीटरों को प्रोसेस करके ईमेल संदेश को स्वरूपित करता है (जैसे प्लेसहोल्डर को बदलता है {{ $parameters.parameter_name }} को इससे प्राप्त वास्तविक वर्कफ़्लो डेटा से message_parameters)

4. सम्मिलन से पहले पैरामीटर मानों को परिवर्तित करने के लिए वैकल्पिक UQL ऑपरेशन लागू करता है (उदाहरण के लिए, डिटेक्शन से वर्ग नाम निकालना, मेट्रिक्स की गणना करना, डेटा फ़िल्टर करना) message_parameters_operations

5. से ईमेल प्राप्तकर्ताओं की सूचियाँ बनाता है receiver_email (आवश्यक), cc_receiver_email, और bcc_receiver_email (एकल ईमेल पतों या सूचियों का समर्थन करता है)

6. संदर्भित वर्कफ़्लो चरण आउटपुट से सामग्री प्राप्त करके और उन्हें ईमेल अटैचमेंट के रूप में एन्कोड करके अटैचमेंट प्रोसेस करता है

7. कॉन्फ़िगर किए गए सर्वर के साथ SSL-सुरक्षित SMTP कनेक्शन स्थापित करता है (sender email और password का उपयोग करके प्रमाणीकरण)

8. के आधार पर ईमेल को समकालिक या असमकालिक रूप से भेजता है fire_and_forget सेटिंग:

   • समकालिक मोड (fire_and_forget=False): ईमेल भेजने के पूर्ण होने की प्रतीक्षा करता है, डिबगिंग के लिए वास्तविक त्रुटि स्थिति लौटाता है

   • असमकालिक मोड (fire_and_forget=True): ईमेल को बैकग्राउंड कार्य में भेजता है, वर्कफ़्लो तुरंत जारी रहता है, त्रुटि स्थिति हमेशा False रहती है

9. सफलता, थ्रॉटलिंग, या त्रुटियों को इंगित करने वाले स्थिति आउटपुट लौटाता है

ब्लॉक गतिशील संदेश सामग्री का समर्थन करता है, जहाँ रनटाइम पर वर्कफ़्लो डेटा द्वारा पैरामीटर प्लेसहोल्डर प्रतिस्थापित किए जाते हैं। संदेश पैरामीटर कच्चे वर्कफ़्लो आउटपुट हो सकते हैं या UQL ऑपरेशनों का उपयोग करके परिवर्तित किए जा सकते हैं (उदाहरण के लिए, गुण निकालना, गणना करना, मान फ़िल्टर करना)। अटैचमेंट अन्य वर्कफ़्लो ब्लॉकों से प्राप्त किए जाते हैं जो स्ट्रिंग या बाइनरी सामग्री उत्पन्न करते हैं (उदाहरण के लिए, रिपोर्ट के लिए CSV फ़ॉर्मेटर, स्क्रीनशॉट के लिए छवि आउटपुट)। कूलडाउन भेजों के बीच न्यूनतम समय लागू करके सूचना स्पैम को रोकता है, हालांकि यह केवल वीडियो प्रोसेसिंग वर्कफ़्लोज़ पर लागू होता है (HTTP अनुरोध संदर्भों पर नहीं)।

आवश्यकताएँ

SMTP सर्वर कॉन्फ़िगरेशन: निम्नलिखित कॉन्फ़िगरेशन वाले SMTP सर्वर तक पहुँच आवश्यक है:

• smtp_server: SMTP सर्वर का होस्टनाम (उदाहरण के लिए, smtp.gmail.com Google के लिए)

• sender_email: प्रेषक के रूप में उपयोग करने के लिए ईमेल पता

• sender_email_password: प्रेषक ईमेल खाते का पासवर्ड (या 2FA वाले Gmail के लिए एप्लिकेशन-विशिष्ट पासवर्ड)

• smtp_port: SMTP पोर्ट (डिफ़ॉल्ट रूप से 465 SSL के लिए)

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

कूलडाउन सीमाएँ: कूलडाउन तंत्र (cooldown_seconds) केवल वीडियो प्रोसेसिंग वर्कफ़्लोज़ पर लागू होता है। HTTP अनुरोध संदर्भों (Roboflow Hosted API, Dedicated Deployment, या self-hosted सर्वर) के लिए, कूलडाउन का कोई प्रभाव नहीं होता क्योंकि प्रत्येक अनुरोध स्वतंत्र होता है।

सामान्य उपयोग के मामले

• अलर्ट सूचनाएँ: जब विशिष्ट स्थितियाँ पता चलें, तब ईमेल अलर्ट भेजें (उदाहरण के लिए, अनधिकृत वस्तुएँ मिलने पर सुरक्षा टीम को अलर्ट करें, विसंगति मिलने पर ऑपरेटरों को सूचित करें, डिटेक्शन गिनती सीमा से अधिक होने पर अलर्ट भेजें), जिससे वास्तविक-समय निगरानी और घटना प्रतिक्रिया सक्षम होती है

• वर्कफ़्लो निष्पादन रिपोर्ट: वर्कफ़्लो परिणामों के साथ समय-समय पर या घटना-आधारित रिपोर्ट जनरेट करें और ईमेल करें (उदाहरण के लिए, डिटेक्शन आँकड़ों के साथ दैनिक सारांश रिपोर्ट, बैच प्रोसेसिंग पूर्णता सूचनाएँ, प्रदर्शन मेट्रिक सारांश), जिससे स्वचालित रिपोर्टिंग और दस्तावेज़ीकरण सक्षम होता है

• डिटेक्शन सारांश: समेकित आँकड़ों के साथ डिटेक्शन परिणामों के ईमेल सारांश भेजें (उदाहरण के लिए, पाए गए ऑब्जेक्ट्स की ईमेल सूचियाँ, गिनतियाँ और वर्गीकरण भेजें, डिटेक्शन विश्वसनीयता सारांश शामिल करें), जिससे हितधारक वर्कफ़्लो आउटपुट से अवगत रह सकें

• त्रुटि और स्थिति सूचनाएँ: वर्कफ़्लो निष्पादन स्थिति और त्रुटियों के बारे में प्रशासकों को सूचित करें (उदाहरण के लिए, वर्कफ़्लो विफल होने पर अलर्ट भेजें, प्रसंस्करण पूर्ण होने की सूचना दें, सिस्टम स्वास्थ्य समस्याएँ रिपोर्ट करें), जिससे उत्पादन तैनाती के लिए निगरानी और डिबगिंग सक्षम होती है

• डेटा निर्यात सूचनाएँ: उत्पन्न डेटा निर्यात और रिपोर्ट ईमेल करें (उदाहरण के लिए, CSV फ़ॉर्मेटर से CSV रिपोर्ट संलग्न करें, निर्यातित डिटेक्शन डेटा भेजें, स्वरूपित विश्लेषण सारांश शामिल करें), जिससे स्वचालित डेटा वितरण और अभिलेखीकरण सक्षम होता है

• बहु-प्राप्तकर्ता अद्यतन: CC/BCC का उपयोग करके एक साथ कई हितधारकों को सूचनाएँ भेजें (उदाहरण के लिए, डिटेक्शन के बारे में टीम सदस्यों को सूचित करें, कई विभागों को अपडेट भेजें, दृश्यता के लिए CC के साथ रिपोर्ट वितरित करें), जिससे कुशल बहु-पक्षीय संचार सक्षम होता है

अन्य ब्लॉक्स से कनेक्ट करना

यह ब्लॉक वर्कफ़्लो चरणों से डेटा प्राप्त करता है और ईमेल सूचनाएँ भेजता है:

• detection या analysis ब्लॉकों के बाद (उदाहरण के लिए, Object Detection, Instance Segmentation, Classification) जब वस्तुएँ पहचानी जाएँ, वर्गीकरण किए जाएँ, या सीमाएँ पार हों, तब अलर्ट या सारांश भेजने के लिए, जिससे वास्तविक-समय सूचना वर्कफ़्लोज़ सक्षम होते हैं

• डेटा प्रोसेसिंग ब्लॉकों के बाद (उदाहरण के लिए, Expression, Property Definition, Detections Filter) ताकि ईमेल सूचनाओं में गणना किए गए मेट्रिक्स, रूपांतरित डेटा, या फ़िल्टर किए गए परिणाम शामिल किए जा सकें, जिससे प्रोसेस किए गए डेटा के साथ अनुकूलित रिपोर्टिंग सक्षम होती है

• फ़ॉर्मेटर ब्लॉकों के बाद (उदाहरण के लिए, CSV Formatter) फ़ॉर्मेट की गई रिपोर्ट और एक्सपोर्ट को ईमेल में संलग्न करने के लिए, जिससे संरचित डेटा और विश्लेषण का स्वचालित वितरण सक्षम होता है

• सशर्त वर्कफ़्लोज़ में (उदाहरण के लिए, Continue If) केवल तब सूचनाएँ भेजने के लिए जब विशिष्ट शर्तें पूरी हों, जिससे घटना-चालित अलर्टिंग और रिपोर्टिंग सक्षम होती है

• समेकन ब्लॉकों के बाद (उदाहरण के लिए, Data Aggregator) समय-समय पर विश्लेषण सारांश और सांख्यिकीय रिपोर्ट ईमेल करने के लिए, जिससे निर्धारित रिपोर्टिंग और रुझान विश्लेषण सक्षम होता है

• निगरानी वर्कफ़्लोज़ में स्थिति अद्यतन, त्रुटि सूचनाएँ, या स्वास्थ्य-जांच रिपोर्ट भेजने के लिए, जिससे स्वचालित सिस्टम निगरानी और घटना प्रबंधन सक्षम होता है

प्रकार पहचानकर्ता

स्टेप में निम्नलिखित पहचानकर्ता का उपयोग करें "type" फ़ील्ड: roboflow_core/email_notification@v1 अपने वर्कफ़्लो में ब्लॉक को एक स्टेप के रूप में जोड़ने के लिए।

गुण

नाम	प्रकार	विवरण	संदर्भ
name	str	इस स्टेप के लिए एक विशिष्ट पहचानकर्ता दर्ज करें..	❌
subject	str	सूचना के लिए ईमेल विषय पंक्ति। यह वह पाठ है जो ईमेल हेडर और प्राप्तकर्ता के इनबॉक्स में विषय फ़ील्ड में दिखाई देता है। इसमें सूचना के उद्देश्य का वर्णन करने वाला स्थिर पाठ शामिल हो सकता है (उदाहरण के लिए, 'वर्कफ़्लो अलर्ट', 'डिटेक्शन सारांश', 'दैनिक रिपोर्ट')..	❌
sender_email	str	सूचना के प्रेषक के रूप में उपयोग करने के लिए ईमेल पता। इस ईमेल खाते के पास कॉन्फ़िगर किए गए SMTP सर्वर और sender_email_password में प्रदान किए गए पासवर्ड तक पहुँच होनी चाहिए। 2FA सक्षम Gmail के लिए, यह वही Gmail पता होना चाहिए जिसके लिए एप्लिकेशन-विशिष्ट पासवर्ड कॉन्फ़िगर किया गया हो..	✅
receiver_email	Union[List[str], str]	सूचना के लिए प्राथमिक प्राप्तकर्ता ईमेल पता(पते)। आवश्यक फ़ील्ड - कम से कम एक प्राप्तकर्ता निर्दिष्ट होना चाहिए। यह एकल ईमेल पता स्ट्रिंग या कई प्राप्तकर्ताओं के लिए ईमेल पतों की सूची हो सकती है। प्राप्तकर्ता प्राप्त ईमेल के 'To' फ़ील्ड में अपने ईमेल पते देखेंगे..	✅
message	str	ईमेल बॉडी सामग्री (सादा पाठ)। प्लेसहोल्डर सिंटैक्स का उपयोग करके गतिशील पैरामीटरों का समर्थन करता है: {{ $parameters.parameter_name }}. प्लेसहोल्डर रनटाइम पर message_parameters के मानों से प्रतिस्थापित किए जाते हैं। संदेश बहु-पंक्ति पाठ हो सकता है। उदाहरण: 'पता चला {{ $parameters.num_objects }} वस्तुएँ। वर्ग: {{ $parameters.classes }}.'.	❌
message_parameters	Dict[str, Union[bool, float, int, str]]	संदेश प्लेसहोल्डरों में उपयोग किए जाने वाले पैरामीटर नामों को वर्कफ़्लो डेटा स्रोतों के साथ मैप करने वाला शब्दकोश। कुंजियाँ संदेश में संदर्भित पैरामीटर नाम हैं जैसे {{ $parameters.key }}; मान वर्कफ़्लो चरण आउटपुट या प्रत्यक्ष मानों के चयनकर्ता हैं। इन मानों को रनटाइम पर संदेश प्लेसहोल्डरों में प्रतिस्थापित किया जाता है। वैकल्पिक रूप से, substitution से पहले पैरामीटर मानों को रूपांतरित करने के लिए message_parameters_operations का उपयोग किया जा सकता है..	✅
message_parameters_operations	Dict[str, List[Union[ClassificationPropertyExtract, ConvertDictionaryToJSON, ConvertImageToBase64, ConvertImageToJPEG, DetectionsFilter, DetectionsOffset, DetectionsPropertyExtract, DetectionsRename, DetectionsSelection, DetectionsShift, DetectionsToDictionary, Divide, ExtractDetectionProperty, ExtractFrameMetadata, ExtractImageProperty, LookupTable, Multiply, NumberRound, NumericSequenceAggregate, PickDetectionsByParentClass, RandomNumber, SequenceAggregate, SequenceApply, SequenceElementsCount, SequenceLength, SequenceMap, SortDetections, StringMatches, StringSubSequence, StringToLowerCase, StringToUpperCase, TimestampToISOFormat, ToBoolean, ToNumber, ToString]]]	message_parameters से पैरामीटर नामों को वैकल्पिक रूप से UQL ऑपरेशन चेन से मैप करने वाला वैकल्पिक शब्दकोश, जो उन्हें संदेश में सम्मिलित करने से पहले पैरामीटर मानों को रूपांतरित करता है। ऑपरेशन क्रम में लागू होते हैं (उदाहरण के लिए, डिटेक्शन से वर्ग नाम निकालना, गिनती की गणना करना, मान फ़िल्टर करना)। कुंजियाँ message_parameters में पैरामीटर नामों से मेल खानी चाहिए। खाली छोड़ें या उन पैरामीटरों को छोड़ दें जिन्हें रूपांतरण की आवश्यकता नहीं है..	❌
cc_receiver_email	Optional[List[str], str]	वैकल्पिक CC (Carbon Copy) प्राप्तकर्ता ईमेल पता(पते)। यह एकल ईमेल पता स्ट्रिंग या ईमेल पतों की सूची हो सकती है। CC प्राप्तकर्ताओं को ईमेल की एक प्रति मिलती है और वे एक-दूसरे के पते देख सकते हैं। उन प्राप्तकर्ताओं के लिए उपयोग करें जिन्हें जानकारी होनी चाहिए लेकिन कार्रवाई करने की आवश्यकता नहीं है..	✅
bcc_receiver_email	Optional[List[str], str]	वैकल्पिक BCC (Blind Carbon Copy) प्राप्तकर्ता ईमेल पता(पते)। यह एकल ईमेल पता स्ट्रिंग या ईमेल पतों की सूची हो सकती है। BCC प्राप्तकर्ताओं को ईमेल की एक प्रति मिलती है, लेकिन उनके पते अन्य प्राप्तकर्ताओं से छिपे रहते हैं। उन प्राप्तकर्ताओं के लिए उपयोग करें जिन्हें सूचना निजी रूप से प्राप्त करनी चाहिए..	✅
smtp_server	str	ईमेल भेजने के लिए उपयोग किया जाने वाला SMTP सर्वर होस्टनाम। सामान्य उदाहरण: Gmail के लिए 'smtp.gmail.com', Outlook के लिए 'smtp.outlook.com', या आपकी संस्था के SMTP सर्वर का होस्टनाम। ब्लॉक SMTP कनेक्शनों के लिए SSL/TLS एन्क्रिप्शन लागू करता है। सुनिश्चित करें कि सर्वर निर्दिष्ट पोर्ट पर SSL का समर्थन करता है..	✅
sender_email_password	str	SMTP सर्वर के साथ प्रमाणीकरण करने के लिए प्रेषक ईमेल खाते का पासवर्ड। 2-चरण सत्यापन सक्षम Gmail के लिए, नियमित Gmail पासवर्ड के बजाय एप्लिकेशन-विशिष्ट पासवर्ड का उपयोग करें। सुरक्षा के लिए इस फ़ील्ड को निजी के रूप में चिह्नित किया गया है। इसे वर्कफ़्लो परिभाषाओं में संग्रहीत करने के बजाय वर्कफ़्लो इनपुट के माध्यम से प्रदान करने की अनुशंसा की जाती है। Roboflow-होस्टेड सेवाओं के लिए, सुरक्षित क्रेडेंशियल प्रबंधन के लिए SECRET_KIND चयनकर्ताओं का उपयोग किया जा सकता है..	✅
smtp_port	int	SMTP सर्वर पोर्ट नंबर। डिफ़ॉल्ट रूप से 465 (SMTP के लिए मानक SSL पोर्ट)। सामान्य विकल्प: TLS के लिए 587 (समर्थित नहीं - यह ब्लॉक SSL लागू करता है), बिना एन्क्रिप्शन के लिए 25 (अनुशंसित नहीं)। सुनिश्चित करें कि पोर्ट इस ब्लॉक द्वारा आवश्यक SSL एन्क्रिप्शन का समर्थन करता है..	❌
fire_and_forget	bool	निष्पादन मोड: असमकालिक बैकग्राउंड भेजने के लिए True (वर्कफ़्लो तुरंत जारी रहता है, error_status हमेशा False, तेज़ निष्पादन), समकालिक भेजने के लिए False (ईमेल पूर्ण होने की प्रतीक्षा करता है, डिबगिंग के लिए वास्तविक त्रुटि स्थिति लौटाता है)। ईमेल भेजने की त्रुटियों को पकड़ने के लिए विकास और डिबगिंग के दौरान False पर सेट करें। जब ईमेल डिलीवरी का समय महत्वपूर्ण न हो, तो तेज़ वर्कफ़्लो निष्पादन के लिए उत्पादन में True पर सेट करें..	✅
disable_sink	bool	रनटाइम पर ईमेल भेजना अक्षम करने वाला फ़्लैग। जब True हो, तो ब्लॉक ईमेल भेजना छोड़ देता है और अक्षम संदेश लौटाता है। वर्कफ़्लो इनपुट के माध्यम से सशर्त सूचना नियंत्रण के लिए उपयोगी (उदाहरण के लिए, कॉलर को परीक्षण के लिए सूचनाएँ अक्षम करने देना, कॉन्फ़िगरेशन के आधार पर सक्षम/अक्षम करना)। रनटाइम नियंत्रण के लिए वर्कफ़्लो इनपुट के माध्यम से सेट करें..	✅
cooldown_seconds	int	सूचना स्पैम रोकने के लिए लगातार ईमेल सूचनाओं के बीच न्यूनतम सेकंड। डिफ़ॉल्ट रूप से 5 सेकंड। कूलडाउन अक्षम करने के लिए 0 पर सेट करें (कोई थ्रॉटलिंग नहीं)। कूलडाउन अवधि के दौरान, ब्लॉक throttling_status=True लौटाता है और भेजना छोड़ देता है। नोट: कूलडाउन केवल वीडियो प्रोसेसिंग वर्कफ़्लोज़ पर लागू होता है, HTTP अनुरोध संदर्भों पर नहीं (Roboflow Hosted API, Dedicated Deployment, या self-hosted सर्वर जहाँ प्रत्येक अनुरोध स्वतंत्र होता है)..	✅

यह संदर्भ स्तंभ यह इंगित करता है कि संपत्ति को वर्कफ़्लो रनटाइम में उपलब्ध गतिशील मानों के साथ पैरामीटराइज़ किया जा सकता है वर्कफ़्लो रनटाइम। देखें बाइंडिंग्स अधिक जानकारी के लिए।

रनटाइम संगतता

सॉफ्ट - रनटाइम hosted_serverless, dedicated_deployment; निष्पादन दूरस्थ : Cooldown / rate-limit timer process memory में संग्रहीत होता है। stateless या multi-replica HTTP runtimes पर remote step execution के साथ प्रत्येक अनुरोध को एक नया worker मिलता है, इसलिए cooldown throttling नहीं करता। Cooldown केवल persistent WebRTC session में local step execution के साथ दस्तावेज़ के अनुसार काम करता है।

इनपुट और आउटपुट बाइंडिंग्स

उपलब्ध कनेक्शन उसके बाइंडिंग प्रकारों पर निर्भर करते हैं। देखें कि कौन-से बाइंडिंग प्रकार ईमेल सूचना संस्करण v1 है।

इनपुट और आउटपुट बाइंडिंग्स

• इनपुट

  • sender_email (string): सूचना के प्रेषक के रूप में उपयोग करने के लिए ईमेल पता। इस ईमेल खाते के पास कॉन्फ़िगर किए गए SMTP सर्वर और sender_email_password में प्रदान किए गए पासवर्ड तक पहुँच होनी चाहिए। 2FA सक्षम Gmail के लिए, यह वही Gmail पता होना चाहिए जिसके लिए एप्लिकेशन-विशिष्ट पासवर्ड कॉन्फ़िगर किया गया हो..

  • receiver_email (Union[list_of_values, string]): सूचना के लिए प्राथमिक प्राप्तकर्ता ईमेल पता(पते)। आवश्यक फ़ील्ड - कम से कम एक प्राप्तकर्ता निर्दिष्ट होना चाहिए। यह एकल ईमेल पता स्ट्रिंग या कई प्राप्तकर्ताओं के लिए ईमेल पतों की सूची हो सकती है। प्राप्तकर्ता प्राप्त ईमेल के 'To' फ़ील्ड में अपने ईमेल पते देखेंगे..

  • message_parameters (*): संदेश प्लेसहोल्डरों में उपयोग किए जाने वाले पैरामीटर नामों को वर्कफ़्लो डेटा स्रोतों के साथ मैप करने वाला शब्दकोश। कुंजियाँ संदेश में संदर्भित पैरामीटर नाम हैं जैसे {{ $parameters.key }}; मान वर्कफ़्लो चरण आउटपुट या प्रत्यक्ष मानों के चयनकर्ता हैं। इन मानों को रनटाइम पर संदेश प्लेसहोल्डरों में प्रतिस्थापित किया जाता है। वैकल्पिक रूप से, substitution से पहले पैरामीटर मानों को रूपांतरित करने के लिए message_parameters_operations का उपयोग किया जा सकता है..

  • cc_receiver_email (Union[list_of_values, string]): वैकल्पिक CC (Carbon Copy) प्राप्तकर्ता ईमेल पता(पते)। यह एकल ईमेल पता स्ट्रिंग या ईमेल पतों की सूची हो सकती है। CC प्राप्तकर्ताओं को ईमेल की एक प्रति मिलती है और वे एक-दूसरे के पते देख सकते हैं। उन प्राप्तकर्ताओं के लिए उपयोग करें जिन्हें जानकारी होनी चाहिए लेकिन कार्रवाई करने की आवश्यकता नहीं है..

  • bcc_receiver_email (Union[list_of_values, string]): वैकल्पिक BCC (Blind Carbon Copy) प्राप्तकर्ता ईमेल पता(पते)। यह एकल ईमेल पता स्ट्रिंग या ईमेल पतों की सूची हो सकती है। BCC प्राप्तकर्ताओं को ईमेल की एक प्रति मिलती है, लेकिन उनके पते अन्य प्राप्तकर्ताओं से छिपे रहते हैं। उन प्राप्तकर्ताओं के लिए उपयोग करें जिन्हें सूचना निजी रूप से प्राप्त करनी चाहिए..

  • attachments (Union[bytes, string]): वैकल्पिक शब्दकोश जो अटैचमेंट फ़ाइलनामों को वर्कफ़्लो चरण आउटपुट से मैप करता है जो फ़ाइल सामग्री प्रदान करते हैं। कुंजियाँ अटैचमेंट फ़ाइलनाम हैं (उदाहरण के लिए, 'report.csv', 'summary.pdf'), मान उन ब्लॉकों के चयनकर्ता हैं जो स्ट्रिंग या बाइनरी सामग्री आउटपुट करते हैं (उदाहरण के लिए, CSV Formatter आउटपुट, छवि डेटा, उत्पन्न रिपोर्ट)। अटैचमेंट एन्कोड किए जाते हैं और ईमेल में संलग्न किए जाते हैं। यदि अटैचमेंट की आवश्यकता नहीं है, तो खाली छोड़ें..

  • smtp_server (string): ईमेल भेजने के लिए उपयोग किया जाने वाला SMTP सर्वर होस्टनाम। सामान्य उदाहरण: Gmail के लिए 'smtp.gmail.com', Outlook के लिए 'smtp.outlook.com', या आपकी संस्था के SMTP सर्वर का होस्टनाम। ब्लॉक SMTP कनेक्शनों के लिए SSL/TLS एन्क्रिप्शन लागू करता है। सुनिश्चित करें कि सर्वर निर्दिष्ट पोर्ट पर SSL का समर्थन करता है..

  • sender_email_password (Union[secret, string]): SMTP सर्वर के साथ प्रमाणीकरण करने के लिए प्रेषक ईमेल खाते का पासवर्ड। 2-चरण सत्यापन सक्षम Gmail के लिए, नियमित Gmail पासवर्ड के बजाय एप्लिकेशन-विशिष्ट पासवर्ड का उपयोग करें। सुरक्षा के लिए इस फ़ील्ड को निजी के रूप में चिह्नित किया गया है। इसे वर्कफ़्लो परिभाषाओं में संग्रहीत करने के बजाय वर्कफ़्लो इनपुट के माध्यम से प्रदान करने की अनुशंसा की जाती है। Roboflow-होस्टेड सेवाओं के लिए, सुरक्षित क्रेडेंशियल प्रबंधन के लिए SECRET_KIND चयनकर्ताओं का उपयोग किया जा सकता है..

  • fire_and_forget (boolean): निष्पादन मोड: असमकालिक बैकग्राउंड भेजने के लिए True (वर्कफ़्लो तुरंत जारी रहता है, error_status हमेशा False, तेज़ निष्पादन), समकालिक भेजने के लिए False (ईमेल पूर्ण होने की प्रतीक्षा करता है, डिबगिंग के लिए वास्तविक त्रुटि स्थिति लौटाता है)। ईमेल भेजने की त्रुटियों को पकड़ने के लिए विकास और डिबगिंग के दौरान False पर सेट करें। जब ईमेल डिलीवरी का समय महत्वपूर्ण न हो, तो तेज़ वर्कफ़्लो निष्पादन के लिए उत्पादन में True पर सेट करें..

  • disable_sink (boolean): रनटाइम पर ईमेल भेजना अक्षम करने वाला फ़्लैग। जब True हो, तो ब्लॉक ईमेल भेजना छोड़ देता है और अक्षम संदेश लौटाता है। वर्कफ़्लो इनपुट के माध्यम से सशर्त सूचना नियंत्रण के लिए उपयोगी (उदाहरण के लिए, कॉलर को परीक्षण के लिए सूचनाएँ अक्षम करने देना, कॉन्फ़िगरेशन के आधार पर सक्षम/अक्षम करना)। रनटाइम नियंत्रण के लिए वर्कफ़्लो इनपुट के माध्यम से सेट करें..

  • cooldown_seconds (पूर्णांक): सूचना स्पैम रोकने के लिए लगातार ईमेल सूचनाओं के बीच न्यूनतम सेकंड। डिफ़ॉल्ट रूप से 5 सेकंड। कूलडाउन अक्षम करने के लिए 0 पर सेट करें (कोई थ्रॉटलिंग नहीं)। कूलडाउन अवधि के दौरान, ब्लॉक throttling_status=True लौटाता है और भेजना छोड़ देता है। नोट: कूलडाउन केवल वीडियो प्रोसेसिंग वर्कफ़्लोज़ पर लागू होता है, HTTP अनुरोध संदर्भों पर नहीं (Roboflow Hosted API, Dedicated Deployment, या self-hosted सर्वर जहाँ प्रत्येक अनुरोध स्वतंत्र होता है)..

• आउटपुट

  • error_status (boolean): बूलियन फ़्लैग.

  • throttling_status (boolean): बूलियन फ़्लैग.

  • message (string): स्ट्रिंग मान.

उदाहरण JSON परिभाषा

{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/email_notification@v1",
	    "subject": "वर्कफ़्लो अलर्ट",
	    "sender_email": "[e-mail]",
	    "receiver_email": "[e-mail]",
	    "message": "पिछले 5 मिनट के दौरान {{ $parameters.num_instances }} उदाहरणों का पता चला",
	    "message_parameters": {
	        "predictions": "$steps.model.predictions",
	        "reference": "$inputs.reference_class_names"
	    },
	    "message_parameters_operations": {
	        "predictions": [
	            {
	                "property_name": "class_name",
	                "type": "DetectionsPropertyExtract"
	            }
	        ]
	    },
	    "cc_receiver_email": "[e-mail]",
	    "bcc_receiver_email": "[e-mail]",
	    "attachments": {
	        "report.cvs": "$steps.csv_formatter.csv_content"
	    },
	    "smtp_server": "$inputs.smtp_server",
	    "sender_email_password": "$inputs.email_password",
	    "smtp_port": 465,
	    "fire_and_forget": "$inputs.fire_and_forget",
	    "disable_sink": false,
	    "cooldown_seconds": "$inputs.cooldown_seconds"
	}