JSON Schema वैलिडेशन के साथ भरोसेमंद n8n डेटा एक्सट्रैक्शन वर्कफ़्लो बनाएँ
ऐसी n8n एक्सट्रैक्शन पाइपलाइन डिज़ाइन करें जो स्ट्रक्चर्ड मॉडल आउटपुट को वैलिडेट करे, अस्थायी गड़बड़ियों पर दोबारा कोशिश करे और अनिश्चित या अमान्य रिकॉर्ड को मानवीय समीक्षा के लिए भेजे।
सारांश · TL;DR
भरोसेमंद एक्सट्रैक्शन वर्कफ़्लो मॉडल के आउटपुट को अविश्वसनीय इनपुट मानता है। सीमित JSON कॉन्ट्रैक्ट तय करें, पार्स किए गए नतीजे को कहीं भी लिखने से पहले वैलिडेट करें, सिर्फ़ अस्थायी गड़बड़ियों पर रीट्राई करें और अनसुलझे या ज़्यादा असर वाले मामलों को किसी व्यक्ति के पास भेजें।
मुख्य बातें
- मॉडल से एक तय फ़ॉर्मैट वाला JSON ऑब्जेक्ट माँगें और फिर उसे मॉडल से स्वतंत्र रूप से वैलिडेट करें।
- अस्थायी API गड़बड़ियों को अमान्य या अधूरे एक्सट्रैक्शन नतीजों से अलग रखें।
- रीट्राई की सीमा तय करें और मूल स्रोत रिकॉर्ड सुरक्षित रखें, ताकि दोबारा चलाने पर डुप्लिकेट न बनें।
- महत्वपूर्ण असर डालने वाली कार्रवाइयों से पहले मानवीय समीक्षा खास तौर पर ज़रूरी है; n8n चुने गए AI Agent टूल के लिए अप्रूवल की सुविधा देता है।
- स्रोत, एक्सट्रैक्ट किए गए नतीजे, वैलिडेशन त्रुटियों, रीट्राई की संख्या और समीक्षक के फ़ैसले का ऑडिट ट्रेल रखें।
इस पृष्ठ पर (7)
डिज़ाइन का अहम फ़ैसला: कार्रवाई से पहले वैलिडेट करें
मॉडल का ऐसा JSON लौटाना जो देखने में सही लगे, यह साबित नहीं करता कि डेटा पूरा है, सही टाइप का है या इस्तेमाल के लिए सुरक्षित है। n8n में एक्सट्रैक्शन को स्पष्ट कॉन्ट्रैक्ट वाली पाइपलाइन की तरह देखें: स्रोत रिकॉर्ड लें, स्ट्रक्चर्ड नतीजा माँगें, उसे पार्स और वैलिडेट करें, फिर आगे बढ़ें, रीट्राई करें या समीक्षा के लिए भेजें। मॉडल के आउटपुट को सीधे डेटाबेस अपडेट या बाहरी संदेश से न जोड़ें।
यह लेख उदाहरण के तौर पर इनवॉइस जैसे रिकॉर्ड का इस्तेमाल करता है। स्कीमा और नोड कॉन्फ़िगरेशन उदाहरण हैं, टेस्ट किया हुआ या किसी खास n8n वर्ज़न के लिए बना एक्सपोर्ट नहीं। अपने n8n वर्ज़न में उपलब्ध नोड विकल्प और चुने हुए मॉडल एंडपॉइंट के समर्थित आउटपुट फ़ॉर्मैट की पुष्टि करें।
1. पहले आउटपुट कॉन्ट्रैक्ट तय करें
स्कीमा में सिर्फ़ वे फ़ील्ड रखें जिनकी अगले चरण को वास्तव में ज़रूरत है। ज़रूरी फ़ील्ड स्पष्ट करें, स्थिर टाइप इस्तेमाल करें और तय करें कि अनुपलब्ध जानकारी को कैसे दिखाना है। उदाहरण के लिए, इनवॉइस की तारीख न होने पर null दें—कोई तारीख गढ़ें नहीं और न ही अपनी ओर से खुला-सा स्पष्टीकरण लिखें।
{
"type": "object",
"additionalProperties": false,
"required": ["invoice_number", "invoice_date", "currency", "total"],
"properties": {
"invoice_number": { "type": "string", "minLength": 1 },
"invoice_date": { "type": ["string", "null"] },
"currency": { "type": "string", "minLength": 3, "maxLength": 3 },
"total": { "type": "number", "minimum": 0 }
}
}
स्कीमा संरचना से जुड़े नियम बताती है; इससे यह तय नहीं होता कि निकाली गई कुल राशि स्रोत दस्तावेज़ से मेल खाती है या नहीं। तारीख को पार्स किया जा सकता है या नहीं, अथवा मुद्रा कोड आपकी स्वीकृत सूची में है या नहीं—ऐसी डोमेन जाँचें अलग से जोड़ें। अनपेक्षित मानों को चुपचाप किसी और रूप में न बदलें: टेक्स्ट में दी गई राशि को संख्या में बदलना उपयोगी हो सकता है, लेकिन इस बदलाव को दर्ज करें और अस्पष्ट फ़ॉर्मैट अस्वीकार करें।
2. n8n वर्कफ़्लो को चरणों में बनाएँ
कैनवस का एक व्यावहारिक लेआउट:
- ट्रिगर और स्रोत प्राप्त करना: फ़ाइल, रिकॉर्ड या webhook payload लें। एक स्थिर source ID तय करें और मूल टेक्स्ट या उसका संदर्भ सुरक्षित रखें।
- एक्सट्रैक्शन अनुरोध: टेक्स्ट और स्पष्ट, संक्षिप्त निर्देश चुने हुए मॉडल को भेजें। सिर्फ़ तय किया गया ऑब्जेक्ट माँगें और बताएं कि अनिश्चित या अनुपलब्ध मानों को कॉन्ट्रैक्ट के अनुसार दिखाया जाए।
- पार्स और वैलिडेट: जवाब को JSON के रूप में पार्स करें, फिर ज़रूरी keys, types, अनुमत मानों और बिज़नेस नियमों की जाँच करें। अपने सेटअप में उपलब्ध schema-validation node इस्तेमाल करें या Code node में ऐसा validator लगाएँ जिसे आपने सोच-समझकर इंस्टॉल और टेस्ट किया हो। यह न मानें कि हर n8n environment में कोई खास validation package उपलब्ध होगा।
- नतीजे के आधार पर रूट करें: वैध रिकॉर्ड गंतव्य तक जाएँ; रीट्राई किए जा सकने वाले फ़ेल्यर तय सीमा वाले रीट्राई पथ पर जाएँ; और बार-बार होने वाली वैलिडेशन विफलताओं या अस्पष्ट मामलों को समीक्षा के लिए भेजें।
- नतीजा दर्ज करें: source ID, स्थिति, एक्सट्रैक्ट किया गया ऑब्जेक्ट, वैलिडेशन त्रुटियाँ, प्रयासों की संख्या और अंतिम फ़ैसला स्टोर करें।
वैलिडेशन चरण को मॉडल अनुरोध से अलग रखें। प्रॉम्प्ट में दिए निर्देश जवाब बेहतर कर सकते हैं, लेकिन वे उसकी जाँच का विकल्प नहीं हैं।
3. सही तरह की विफलताओं पर रीट्राई करें
अस्थायी ट्रांसपोर्ट त्रुटियों, rate limits या सर्विस-साइड विफलताओं में रीट्राई मददगार है। इससे इनवॉइस नंबर की कमी या बार-बार स्कीमा का उल्लंघन करने वाला जवाब ठीक नहीं होगा। रीट्राई की सीमा कम रखें और जहाँ आपके नोड में सुविधा हो, प्रयासों के बीच देरी रखें। अपने n8n वर्ज़न में रीट्राई के सटीक नियंत्रण की पुष्टि करें; सेटिंग और व्यवहार नोड के अनुसार अलग हो सकते हैं।
अलग-अलग नतीजों के लिए अलग शाखाएँ बनाएँ:
- अस्थायी अनुरोध त्रुटि: तय सीमा तक रीट्राई करें, फिर रिकॉर्ड को आगे की जाँच के लिए विफल के रूप में चिह्नित करें।
- अमान्य JSON: ज़रूरत हो तो एक नियंत्रित सुधार प्रयास करें और वही फ़ील्ड व कॉन्ट्रैक्ट माँगें। नए जवाब को फिर से वैलिडेट करें; यह न मानें कि सुधार सफल रहा है।
- स्कीमा या बिज़नेस नियम की विफलता: अनिश्चितकाल तक लूप चलाने के बजाय समीक्षा के लिए भेजें।
- वैध नतीजा: रिकॉर्ड को गंतव्य तक भेजें और वर्कफ़्लो दोबारा चलने पर डुप्लिकेट लिखे जाने से बचने के लिए source ID का इस्तेमाल करें।
रीट्राई से कोई ऐसा डाउनस्ट्रीम काम दोबारा नहीं होना चाहिए जिसे पलटा न जा सके। मॉडल एक्सट्रैक्शन और डेटा लिखने के चरण अलग रखें और जहाँ संभव हो, डेटा लिखने की प्रक्रिया को idempotent बनाएँ।
4. जोखिम घटाने के लिए मानवीय समीक्षा जोड़ें
जब कोई मान अस्पष्ट हो, वैलिडेशन नियम विफल हो या अगली कार्रवाई के गंभीर नतीजे हो सकते हों, तब मानवीय समीक्षा उपयोगी है। समीक्षक को मूल स्रोत, प्रस्तावित फ़ील्ड, वैलिडेशन की खास त्रुटियाँ और मंज़ूर करने, संपादित करने या अस्वीकार करने के स्पष्ट विकल्प दें। समीक्षक का फ़ैसला और किए गए सुधार सुरक्षित रखें।
n8n के दस्तावेज़ों में AI Agent से जुड़े चुने हुए टूल के लिए human approval बताया गया है: वर्कफ़्लो रुकता है, समीक्षक प्रस्तावित टूल कॉल को मंज़ूर या अस्वीकार कर सकता है और टूल सिर्फ़ मंज़ूरी मिलने पर चलता है। अप्रूवल को Slack, Telegram या n8n Chat जैसे समर्थित चैनलों के ज़रिए भेजा जा सकता है। दस्तावेज़ों में समीक्षक को प्रस्तावित टूल और उसके पैरामीटर दिखाने के लिए $tool.name और $tool.parameters का इस्तेमाल भी बताया गया है। यह AI Agent टूल कॉल का अप्रूवल है; अपने आप में हर एक्सट्रैक्ट किए गए रिकॉर्ड की समीक्षा का सामान्य इंटरफ़ेस नहीं। रिकॉर्ड-स्तर की समीक्षा के लिए अपने डिप्लॉयमेंट के हिसाब से उपयुक्त मानवीय टास्क और उसे फिर से शुरू करने का रास्ता बनाएँ।
स्रोत: n8n दस्तावेज़: टूल के लिए Human-in-the-loop।
5. सबूतों के आधार पर समस्या हल करें
अगर वैध रिकॉर्ड बार-बार अस्वीकार हो रहे हैं, तो स्कीमा बदलने से पहले कच्चा जवाब और validator की त्रुटियाँ देखें। जाँचें कि जवाब में markdown fences, अतिरिक्त टेक्स्ट, अनुपस्थित nullable फ़ील्ड या स्ट्रिंग के रूप में लिखे नंबर तो नहीं हैं। अगर रीट्राई से डुप्लिकेट रिकॉर्ड बनते हैं, तो डेटा लिखने का काम वैलिडेशन के बाद रखें और स्थिर source identifier इस्तेमाल करें। अगर समीक्षकों के लिए जल्दी फ़ैसला करना मुश्किल हो, तो सिर्फ़ JSON ऑब्जेक्ट भेजने के बजाय हर संदिग्ध फ़ील्ड के समर्थन में स्रोत का सटीक अंश शामिल करें।
सिर्फ़ पास होने की दर बढ़ाने के लिए स्कीमा को ढीला न करें। बदला हुआ कॉन्ट्रैक्ट डाउनस्ट्रीम की वास्तविक ज़रूरत के अनुरूप होना चाहिए और उसके असर की जाँच प्रतिनिधि इनपुट पर करें—जिनमें अनुपस्थित फ़ील्ड, गलत फ़ॉर्मैट वाले दस्तावेज़ और आपस में टकराते मान शामिल हों।
दोबारा इस्तेमाल करने योग्य रिलीज़ चेकलिस्ट
- ज़रूरी फ़ील्ड, null का व्यवहार, टाइप और अतिरिक्त फ़ील्ड से जुड़ी नीति तय है।
- डाउनस्ट्रीम डेटा लिखने से पहले पार्सिंग, स्कीमा जाँच और डोमेन जाँच होती है।
- रीट्राई की सीमा तय है और इन्हें सिर्फ़ उन विफलताओं तक रखा गया है जिनके ठीक होने की उचित संभावना है।
- दोबारा प्रोसेस करने पर अहम कार्रवाइयाँ गलती से डुप्लिकेट नहीं होतीं।
- समीक्षकों को स्रोत, प्रस्तावित मान और समीक्षा के लिए भेजने की वजह दिखाई देती है।
- लॉग में जाँच के लिए पर्याप्त जानकारी रहती है और अस्वीकृत आउटपुट छिपाया नहीं जाता।
भरोसेमंद तरीका सीधा है: एक्सट्रैक्ट करें, वैलिडेट करें, रूट करें और उसके बाद ही कार्रवाई करें। स्कीमा संरचना की समस्याएँ पकड़ती है; सीमित रीट्राई अस्थायी विफलताओं से निपटता है; और मानवीय समीक्षा उन अस्पष्टताओं व जोखिमों को संभालती है जिन्हें ऑटोमेशन को चुपचाप हल नहीं करना चाहिए।
सामान्य प्रश्न
क्या मॉडल से JSON माँगने पर स्कीमा के मुताबिक आउटपुट मिलने की गारंटी होती है?
नहीं। जवाब को अविश्वसनीय इनपुट मानें: इस्तेमाल करने से पहले वर्कफ़्लो में उसे पार्स करें और ज़रूरी फ़ील्ड, टाइप तथा बिज़नेस नियम वैलिडेट करें।
अगर एक्सट्रैक्ट किया गया JSON वैलिडेशन में विफल हो, तो क्या n8n को रीट्राई करना चाहिए?
बिना सीमा तय किए अपने आप रीट्राई न करें। एक सुधार प्रयास उपयोगी हो सकता है, लेकिन स्कीमा की बार-बार होने वाली विफलताओं को अनिश्चितकाल तक रीट्राई करने के बजाय आम तौर पर समीक्षा या जाँच के लिए भेजना चाहिए।
क्या n8n का human-in-the-loop अप्रूवल एक्सट्रैक्ट किए गए रिकॉर्ड की समीक्षा कर सकता है?
यहाँ उद्धृत n8n सुविधा AI Agent के टूल कॉल को मंज़ूर या अस्वीकार करती है। यह अपने आप रिकॉर्ड की सामान्य समीक्षा का इंटरफ़ेस नहीं देती; एक्सट्रैक्शन के मामलों के लिए उपयुक्त मानवीय टास्क और उसे फिर से शुरू करने का रास्ता बनाएँ।
समीक्षक को क्या दिखाना चाहिए?
मूल स्रोत या उसका प्रासंगिक अंश, प्रस्तावित स्ट्रक्चर्ड फ़ील्ड, वैलिडेशन त्रुटियाँ या अनिश्चितता, और मंज़ूर करने, संपादित करने या अस्वीकार करने का स्पष्ट विकल्प दिखाएँ।
संबंधित लेख
Guides
n8n में रिकवर किया जा सकने वाला डेटा एक्सट्रैक्शन वर्कफ़्लो बनाएं
ऐसा n8n एक्सट्रैक्शन वर्कफ़्लो डिज़ाइन करें जो रिकॉर्ड वैलिडेट करे, अस्थायी विफलताओं पर दोबारा प्रयास करे और अपवादों को मानवीय समीक्षा के लिए भेजे, बिना डुप्लिकेट राइट किए।
Guides
n8n में गोपनीयता का ध्यान रखने वाला डेटा एक्सट्रैक्शन वर्कफ़्लो बनाएं
ऐसा n8n एक्सट्रैक्शन वर्कफ़्लो डिज़ाइन करें जो संरचित आउटपुट को वैलिडेट करे, विफलताओं को सुरक्षित ढंग से संभाले और संवेदनशील कार्रवाइयों को मानवीय समीक्षा के लिए भेजे।
Guides
सत्यापन, रीट्राई और मानवीय समीक्षा के साथ दोहराने योग्य n8n डेटा निष्कर्षण वर्कफ़्लो बनाएँ
ऐसा n8n निष्कर्षण वर्कफ़्लो डिज़ाइन करें जो संरचित आउटपुट का सत्यापन करे, अस्थायी विफलताओं पर रीट्राई करे, अनिश्चित रिकॉर्ड समीक्षा के लिए भेजे और तय परीक्षण मामलों के आधार पर मूल्यांकन योग्य हो।
Guides
n8n में दस्तावेज़ Q&A वर्कफ़्लो बनाएं: सत्यापित उद्धरण और मानवीय समीक्षा
ऐसा n8n वर्कफ़्लो डिज़ाइन करें जो दस्तावेज़ों से साक्ष्य निकाले, संरचित जवाबों की जाँच करे, सीमित और सुरक्षित रीट्राई करे तथा अनिश्चित परिणामों को मानव समीक्षा के लिए भेजे।