GuidesOneMux

n8n में रिकवर किया जा सकने वाला डेटा एक्सट्रैक्शन वर्कफ़्लो बनाएं

ऐसा n8n एक्सट्रैक्शन वर्कफ़्लो डिज़ाइन करें जो रिकॉर्ड वैलिडेट करे, अस्थायी विफलताओं पर दोबारा प्रयास करे और अपवादों को मानवीय समीक्षा के लिए भेजे, बिना डुप्लिकेट राइट किए।

AI

सारांश · TL;DR

n8n में संरचित रिकॉर्ड निकालने, अस्थायी विफलताओं को अमान्य डेटा से अलग करने और रुकावट के बाद सुरक्षित रिकवरी के लिए एक व्यावहारिक डिज़ाइन।

मुख्य बातें

  • किसी भी डाउनस्ट्रीम राइट से पहले निकाले गए फ़ील्ड वैलिडेट करें और अमान्य रिकॉर्ड को बार-बार रीट्राई करने के बजाय समीक्षा के लिए भेजें।
  • अस्थायी विफलताओं के लिए सीमित रीट्राई का उपयोग करें और सीमा पूरी होने पर एस्केलेशन के स्पष्ट रास्ते के साथ एक स्थायी रीट्राई रिकॉर्ड रखें।
  • डाउनस्ट्रीम राइट को एटॉमिक आइडेम्पोटेंसी तंत्र से सुरक्षित करें और रीट्राई से पहले अस्पष्ट नतीजों का मिलान करें।
  • एजेंट द्वारा शुरू की गई जोखिमपूर्ण कार्रवाइयों के लिए n8n की AI Agent टूल अप्रूवल सुविधा इस्तेमाल करें; निकाले गए डेटा में सुधार के लिए अलग समीक्षा प्रक्रिया बनाएं।
इस पृष्ठ पर (8)

रिकवरी कॉन्ट्रैक्ट से शुरुआत करें

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

नीचे दिया गया उदाहरण इनवॉइस डेटा निकालता है और स्वीकृत रिकॉर्ड किसी डेस्टिनेशन सिस्टम में लिखता है। यह एक उदाहरणात्मक डिज़ाइन है, परीक्षण किया हुआ वर्कफ़्लो नहीं। Node विकल्प और इंटीग्रेशन, n8n के वर्शन और डेस्टिनेशन के अनुसार अलग-अलग होते हैं; अपने एनवायरनमेंट में इनकी पुष्टि करें।

आवश्यकताएं और वर्कफ़्लो की रूपरेखा

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

इस तार्किक क्रम का उपयोग करें:

  1. ट्रिगर और रजिस्टर करें: दस्तावेज़ का रेफ़रेंस प्राप्त करें। एक स्थिर स्रोत ID और दस्तावेज़ वर्शन का उपयोग करके स्थायी जॉब बनाएं या खोजें।
  2. एक्सट्रैक्ट करें: दस्तावेज़ प्राप्त करें और अपने चुने हुए एक्सट्रैक्टर से संरचित फ़ील्ड का अनुरोध करें।
  3. वैलिडेट करें: लौटाए गए डेटा को स्पष्ट कॉन्ट्रैक्ट के विरुद्ध जांचें।
  4. रूट करें: वैध रिकॉर्ड को राइट पाथ पर और अमान्य रिकॉर्ड को समीक्षा कतार में भेजें।
  5. राइट और मिलान करें: एक स्थिर आइडेम्पोटेंसी की के साथ राइट करें, फिर डेस्टिनेशन ID और नतीजा दर्ज करें।
  6. रिकवर करें: एक अलग शेड्यूल्ड वर्कफ़्लो उन जॉब को खोजता है जिनका रीट्राई देय है या जो ऑपरेशनल सीमा से अधिक समय से अटकी हैं।

ट्रेसिंग के लिए ट्रिगर एक्ज़ीक्यूशन ID उपयोगी है, लेकिन दोबारा चलाने पर यह दस्तावेज़ की विश्वसनीय पहचान नहीं है। स्रोत सिस्टम के दस्तावेज़ ID के साथ वर्शन या कंटेंट डाइजेस्ट को प्राथमिकता दें। ऑटोमैटिक रीप्रोसेसिंग चालू करने से पहले तय करें कि सुधारे गए दस्तावेज़ को नया वर्शन कैसे मिलेगा।

राइट करने से पहले निकाले गए रिकॉर्ड को वैलिडेट करें

इस उदाहरण में invoice_id, currency और amount_minor को अनिवार्य रखें। वैलिडेशन के दौरान फ़्लोटिंग-पॉइंट राउंडिंग से बचने के लिए रकम को मुद्रा की छोटी इकाइयों, जैसे सेंट, में दर्शाएं। कॉन्ट्रैक्ट मानता है कि एक्सट्रैक्टर ने मुद्रा के नियमों के अनुसार रकम पहले ही बदल दी है; वास्तविक इम्प्लीमेंटेशन में यह भी जांचना होगा कि मुद्रा समर्थित है और कोई भी कन्वर्ज़न उचित है।

एक्सट्रैक्शन के बाद Code node लगाएं। नीचे दिया गया उदाहरणात्मक JavaScript हर इनकमिंग आइटम की जांच करता है और खराब डेटा पर त्रुटि फेंकने के बजाय समीक्षा योग्य नतीजा लौटाता है। Node को सभी इनकमिंग आइटम प्रोसेस करने के लिए कॉन्फ़िगर करें और सुनिश्चित करें कि इस node के चलने से पहले हर आइटम का JSON निकाला गया रिकॉर्ड हो।

return $input.all().map((item) => {
  const record = item.json;
  const errors = [];

  if (typeof record.invoice_id !== 'string' || !record.invoice_id.trim()) {
    errors.push('invoice_id must be a non-empty string');
  }
  if (typeof record.currency !== 'string' || !/^[A-Z]{3}$/.test(record.currency)) {
    errors.push('currency must be a three-letter uppercase code');
  }
  if (!Number.isSafeInteger(record.amount_minor) || record.amount_minor < 0) {
    errors.push('amount_minor must be a non-negative safe integer');
  }

  return {
    json: {
      record,
      validation: { valid: errors.length === 0, errors },
    },
  };
});

इसके बाद validation.valid जांचने वाला IF node लगाएं। इस आउटपुट के साथ जॉब ID और स्रोत रेफ़रेंस सुरक्षित रखें, चाहे आइटम में या अपने स्टेट स्टोर से खोजकर। Regex मुद्रा कोड का स्वरूप जांचता है, यह नहीं कि वह वास्तव में समर्थित मुद्रा है या नहीं। राइट से पहले सप्लायर मिलान और डुप्लिकेट इनवॉइस पहचान जैसी बिज़नेस जांच जोड़ें।

जिन गलत प्रारूप वाले रिस्पॉन्स को आइटम में पार्स नहीं किया जा सकता, उनके लिए अलग एरर पाथ चाहिए। यह न मानें कि हर एक्सट्रैक्शन विफलता के बाद वैलिडेशन node को उपयोग योग्य रिकॉर्ड मिलेगा। सुरक्षित डायग्नोस्टिक जानकारी स्टोर करें और लगातार होने वाली पार्स विफलताओं को समीक्षा के लिए भेजें।

रीट्राई और एस्केलेशन के नियम तय करें

रीट्राई से जुड़े निर्णय स्पष्ट रखें। नीचे शुरुआती नीति दी गई है; यह गारंटी नहीं है कि हर सेवा इन स्टेटस कोड का एक ही तरह उपयोग करती है।

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

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

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

राइट को सुरक्षित रिकवरी के योग्य बनाएं

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

यदि डेस्टिनेशन में ऐसी सुविधा नहीं है, तो एटॉमिक विशिष्टता बाधा और मिलान प्रक्रिया वाले मध्यवर्ती स्टोर का उपयोग करें। केवल इससे अलग सिस्टम में ठीक एक बार प्रभाव होने की गारंटी नहीं मिल सकती: वहां राइट सफल हो सकता है जबकि आपकी प्रक्रिया को रिस्पॉन्स न मिले। ऐसी स्थिति में, रीट्राई से पहले स्थिर बाहरी रेफ़रेंस से डेस्टिनेशन क्वेरी करें, या डेस्टिनेशन को भरोसेमंद ढंग से क्वेरी न कर पाने पर मामला ऑपरेटर को भेजें।

received, extracting, review_required, ready_to_write, write_unknown और completed जैसी स्थितियां ट्रैक करें। प्रगति में मौजूद काम के लिए लीज़ या समय-सीमा तय करें और रिकवरी प्रक्रिया से समाप्त हो चुकी लीज़ की जांच कराएं। राइट की पुष्टि होने के बाद ही डेस्टिनेशन रिकॉर्ड ID स्टोर करें। प्रयासों का इतिहास और स्टेट ट्रांज़िशन रखें, ताकि ऑपरेटर लॉग में दस्तावेज़ की अनावश्यक सामग्री उजागर किए बिना बता सके कि क्या हुआ।

सही चरण पर मानवीय समीक्षा जोड़ें

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

जब कोई AI Agent किसी टूल को कॉल करता है, तब n8n की एक अलग सुविधा लागू होती है। n8n का human-in-the-loop दस्तावेज़ बताता है कि चुने हुए टूल कॉल मंजूरी या अस्वीकृति के लिए रुक सकते हैं और समीक्षक को प्रस्तावित टूल तथा पैरामीटर दिखा सकते हैं। Agent के Tools पैनल में मानवीय समीक्षा चरण जोड़ें, समर्थित चैनल कॉन्फ़िगर करें और उन टूल को कनेक्ट करें जिनके लिए मंजूरी जरूरी है। दस्तावेज़ एजेंट के सिस्टम प्रॉम्प्ट में यह बताने की भी सलाह देता है कि किन टूल को मंजूरी चाहिए और अस्वीकृति को कैसे संभालना है।

यह टूल अप्रूवल स्कीमा वैलिडेशन या सामान्य उद्देश्य वाली रिकॉर्ड-सुधार कतार का विकल्प नहीं है। स्वीकृत टूल AI द्वारा प्रस्तावित इनपुट के साथ चलता है; यदि समीक्षक को निकाले गए फ़ील्ड बदलने हों, तो सुधार पाथ का उपयोग करें और किसी भी राइट से पहले दोबारा वैलिडेट करें।

लॉन्च से पहले ऑपरेशनल जांच

  • गायब फ़ील्ड, गलत प्रारूप वाले एक्सट्रैक्शन रिस्पॉन्स, रेट लिमिट, समाप्त हो चुके क्रेडेंशियल और अस्वीकृत समीक्षा का परीक्षण करें।
  • ऐसे डेस्टिनेशन राइट का सिमुलेशन करें जो सफल हो लेकिन रिस्पॉन्स न लौटाए; पुष्टि करें कि रिकवरी बिना जांचे दोबारा इंसर्ट करने के बजाय मिलान करती है।
  • पुष्टि करें कि समवर्ती रिकवरी वर्कर एक ही जॉब क्लेम नहीं कर सकते और रीट्राई सीमा में सभी रीट्राई स्तर शामिल हैं।
  • पुराने लंबित समीक्षा कार्यों, समाप्त रीट्राई, समाप्त लीज़ और अज्ञात राइट नतीजों पर अलर्ट दें। जांचें कि ऑपरेटर स्रोत ढूंढ सकता है और हर जॉब को सुरक्षित रूप से फिर शुरू या बंद कर सकता है।

सावधानीपूर्ण रीट्राई सीमाओं और समीक्षा नियमों से शुरुआत करें, फिर देखी गई विफलता श्रेणियों के आधार पर उन्हें समायोजित करें। ऑटोमेशन बढ़ने पर भी वैलिडेशन और आइडेम्पोटेंसी की सीमाएं बनाए रखें।

स्रोत

  • n8n: Human-in-the-loop for tools — टूल अप्रूवल का व्यवहार, सेटअप, चैनल और एजेंट प्रॉम्प्ट संबंधी मार्गदर्शन।

सामान्य प्रश्न

क्या n8n वर्कफ़्लो को स्कीमा वैलिडेशन में विफल रिकॉर्ड पर रीट्राई करना चाहिए?

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

क्या n8n की मानवीय समीक्षा निकाले गए डेटा को अपने आप वैलिडेट करती है?

नहीं। दस्तावेज़ में बताई गई AI Agent टूल-समीक्षा सुविधा किसी व्यक्ति से प्रस्तावित टूल कॉल को मंजूर या अस्वीकार करने के लिए कहती है। स्कीमा वैलिडेशन और रिकॉर्ड-सुधार प्रक्रिया के लिए अलग वर्कफ़्लो डिज़ाइन चाहिए।

टाइमआउट के बाद वर्कफ़्लो डुप्लिकेट राइट से कैसे बच सकता है?

स्थिर ऑपरेशन की का दोबारा उपयोग करें और डेस्टिनेशन से उसे एटॉमिक रूप से लागू कराएं। नतीजा अज्ञात हो तो रीट्राई से पहले डेस्टिनेशन से मिलान करें; नतीजा पता न चल सके तो मामला एस्केलेट करें।

संबंधित लेख

Guides

n8n में गोपनीयता का ध्यान रखने वाला डेटा एक्सट्रैक्शन वर्कफ़्लो बनाएं

ऐसा n8n एक्सट्रैक्शन वर्कफ़्लो डिज़ाइन करें जो संरचित आउटपुट को वैलिडेट करे, विफलताओं को सुरक्षित ढंग से संभाले और संवेदनशील कार्रवाइयों को मानवीय समीक्षा के लिए भेजे।

阅读全文 →

Guides

n8n में दस्तावेज़ Q&A वर्कफ़्लो बनाएं: सत्यापित उद्धरण और मानवीय समीक्षा

ऐसा n8n वर्कफ़्लो डिज़ाइन करें जो दस्तावेज़ों से साक्ष्य निकाले, संरचित जवाबों की जाँच करे, सीमित और सुरक्षित रीट्राई करे तथा अनिश्चित परिणामों को मानव समीक्षा के लिए भेजे।

阅读全文 →

Guides

JSON Schema वैलिडेशन के साथ भरोसेमंद n8n डेटा एक्सट्रैक्शन वर्कफ़्लो बनाएँ

ऐसी n8n एक्सट्रैक्शन पाइपलाइन डिज़ाइन करें जो स्ट्रक्चर्ड मॉडल आउटपुट को वैलिडेट करे, अस्थायी गड़बड़ियों पर दोबारा कोशिश करे और अनिश्चित या अमान्य रिकॉर्ड को मानवीय समीक्षा के लिए भेजे।

阅读全文 →

Guides

सत्यापन, रीट्राई और मानवीय समीक्षा के साथ दोहराने योग्य n8n डेटा निष्कर्षण वर्कफ़्लो बनाएँ

ऐसा n8n निष्कर्षण वर्कफ़्लो डिज़ाइन करें जो संरचित आउटपुट का सत्यापन करे, अस्थायी विफलताओं पर रीट्राई करे, अनिश्चित रिकॉर्ड समीक्षा के लिए भेजे और तय परीक्षण मामलों के आधार पर मूल्यांकन योग्य हो।

阅读全文 →