GuidesOneMux

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

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

AI

सारांश · TL;DR

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

मुख्य बातें

  • निष्कर्षण के परिणाम को अविश्वसनीय इनपुट मानें, जब तक वह स्कीमा और व्यावसायिक नियमों की जाँच में सफल न हो जाए।
  • रीट्राई की सीमा तय करें और अस्थायी त्रुटियों को मॉडल के अमान्य आउटपुट से अलग रखें।
  • अस्पष्ट रिकॉर्ड या महत्त्वपूर्ण कार्रवाइयों के लिए मानवीय समीक्षा लें; समीक्षक को प्रस्तावित सटीक मान दिखाएँ।
  • अपेक्षित आउटपुट और स्पष्ट पास मानदंडों वाला तय परीक्षण सेट रखें, ताकि बदलावों की तुलना एकसमान ढंग से की जा सके।
इस पृष्ठ पर (7)

n8n निष्कर्षण वर्कफ़्लो पर भरोसा करना आसान होता है, जब उसमें तीन अलग-अलग पड़ाव हों: स्कीमा सत्यापन, सीमित रिकवरी और मानवीय समीक्षा। AI से मिले जवाब को सीधे डेटाबेस अपडेट या बाहरी संदेश में न भेजें। पहले जाँचें कि उसका स्वरूप अपेक्षित है, फिर तय करें कि उसे स्वचालित रूप से संसाधित करना सुरक्षित है या नहीं।

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

सीमित निष्कर्षण अनुबंध से शुरुआत करें

एक रिकॉर्ड प्रकार चुनें और तय करें कि आगे के नोड को ठीक किन फ़ील्ड की ज़रूरत है। उदाहरण के लिए, इनवॉइस फ़ील्ड निकालने पर यह परिणाम मिल सकता है:

{
  "invoice_number": "INV-1042",
  "invoice_date": "2025-02-14",
  "total": 128.50,
  "currency": "USD"
}

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

  • invoice_number: गैर-रिक्त स्ट्रिंग।
  • invoice_date: मान्य ISO तारीख (YYYY-MM-DD)।
  • total: शून्य से बड़ा या उसके बराबर परिमित संख्या।
  • currency: तीन बड़े अक्षर।
  • अज्ञात मान: null का उपयोग केवल तभी करें, जब अनुबंध इसकी अनुमति देता हो; कभी अनुमान न लगाएँ।

ये व्यावसायिक नियमों के उदाहरण हैं, n8n की ओर से लगाई गई आवश्यकताएँ नहीं। अपने स्रोत दस्तावेज़ों और गंतव्य सिस्टम के अनुरूप नियम तय करें।

वर्कफ़्लो को अलग-अलग चरणों में बनाएँ

एक व्यावहारिक वर्कफ़्लो का क्रम इस तरह हो सकता है:

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

पार्सिंग के बाद बुनियादी जाँच लागू करने के लिए Validation Code नोड का उपयोग किया जा सकता है। अपने पिछले नोड के अनुसार इनपुट प्रॉपर्टी और null संबंधी नीति समायोजित करें:

const item = $input.first().json;
const data = item.extraction; // Set this to the parsed extraction object.
const errors = [];

if (!data || typeof data !== 'object' || Array.isArray(data)) {
  errors.push('Extraction must be a JSON object');
} else {
  if (typeof data.invoice_number !== 'string' || !data.invoice_number.trim()) {
    errors.push('invoice_number must be a non-empty string');
  }

  if (typeof data.invoice_date !== 'string' ||
      !/^\d{4}-\d{2}-\d{2}$/.test(data.invoice_date) ||
      Number.isNaN(Date.parse(`${data.invoice_date}T00:00:00Z`))) {
    errors.push('invoice_date must be a valid YYYY-MM-DD date');
  }

  if (typeof data.total !== 'number' || !Number.isFinite(data.total) || data.total < 0) {
    errors.push('total must be a finite, non-negative number');
  }

  if (typeof data.currency !== 'string' || !/^[A-Z]{3}$/.test(data.currency)) {
    errors.push('currency must be three uppercase letters');
  }
}

return [{ json: { ...item, valid: errors.length === 0, validation_errors: errors } }];

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

सही त्रुटियों पर रीट्राई करें—और फिर रोक दें

ऐसी संभावित अस्थायी विफलताओं के लिए रीट्राई की छोटी और स्पष्ट सीमा तय करें, जैसे रेट लिमिट या अस्थायी कनेक्शन त्रुटि। जहाँ उपलब्ध हों, नोड की रीट्राई सेटिंग का उपयोग करें; या प्रयासों की गिनती और देरी के साथ नियंत्रित लूप बनाएँ। किसी खास सेटिंग पर निर्भर होने से पहले पुष्टि करें कि आपका n8n संस्करण त्रुटियों और रीट्राई को कैसे संभालता है।

स्कीमा की विफलता को नेटवर्क समस्या समझकर आँख मूँदकर रीट्राई न करें। सुधार का सीमित प्रयास उपयोगी हो सकता है—उदाहरण के लिए, निष्कर्षण चरण से उन्हीं फ़ील्ड को मान्य JSON के रूप में लौटाने को कहें—लेकिन इसे एक अलग और स्पष्ट सीमा में गिनें। जवाब फिर भी अमान्य हो, तो उसे समीक्षा के लिए भेजें या विफल चिह्नित करें। लूप को कभी भी बिना सीमा के न चलने दें।

retryable_error, invalid_output और needs_review जैसे अलग-अलग परिणाम रखें। इससे वर्कफ़्लो रन की समस्या पहचानना आसान होता है और अमान्य रिकॉर्ड को सफल निष्कर्षण समझने से बचा जा सकता है।

लोगों को सही निर्णय बिंदु पर शामिल करें

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

n8n का दस्तावेज़ीकृत AI Agent मानवीय-समीक्षा फ़ीचर अलग तरह से काम करता है: एजेंट द्वारा उन्हें निष्पादित करने से पहले चुने हुए टूल के लिए स्वीकृति ज़रूरी की जा सकती है। वर्कफ़्लो रुक जाता है और समीक्षक प्रस्तावित टूल कॉल को स्वीकार या अस्वीकार कर सकता है; समीक्षक को टूल और उसके पैरामीटर दिखाई देते हैं। गाइड में Slack, Telegram और n8n Chat समेत कई चैनल दिए गए हैं, और संदर्भ देने के लिए $tool.name और $tool.parameters के उपयोग का उल्लेख है। सिस्टम प्रॉम्प्ट में बताएँ कि अस्वीकृति का क्या अर्थ है और एजेंट को उस पर कैसे प्रतिक्रिया देनी चाहिए। इस फ़ीचर का उपयोग तब करें, जब एजेंट कोई कार्रवाई करने वाला हो—जैसे रिकॉर्ड में बदलाव करना—न कि निकाले गए फ़ील्ड के सत्यापन के विकल्प के रूप में। आधिकारिक सेटअप गाइड देखें।

तय मामलों से मूल्यांकन को दोहराने योग्य बनाएँ

एक छोटा फ़िक्स्चर सेट बनाएँ, जिसमें सामान्य, विकृत और अस्पष्ट इनपुट हों। हर मामले के लिए अपेक्षित फ़ील्ड, अपेक्षित सत्यापन परिणाम और यह दर्ज करें कि मानवीय समीक्षा चाहिए या नहीं। प्रॉम्प्ट, स्कीमा, पार्सिंग लॉजिक या मॉडल कॉन्फ़िगरेशन में बदलाव करने पर हर बार इन्हीं मामलों को चलाएँ।

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

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

समस्या-निवारण चेकलिस्ट

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

निष्कर्ष

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

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

क्या n8n का AI Agent मानवीय-समीक्षा फ़ीचर निकाले गए डेटा का सत्यापन करता है?

नहीं। दस्तावेज़ीकृत फ़ीचर AI Agent के चुने हुए टूल कॉल को स्वीकृति या अस्वीकृति के लिए रोकता है। निकाले गए फ़ील्ड को सहेजने या उन पर कार्रवाई करने से पहले अलग से सत्यापित करें।

क्या मॉडल के अमान्य आउटपुट पर रीट्राई करना चाहिए?

इसे अस्थायी त्रुटि मानकर नहीं। आप सुधार का सीमित प्रयास रख सकते हैं, लेकिन इसे अस्थायी सेवा विफलताओं वाली रीट्राई से अलग रखें और बार-बार अमान्य आउटपुट मिलने पर समीक्षा या विफलता-प्रबंधन के लिए भेजें।

निष्कर्षण मूल्यांकन में किन चीज़ों का परीक्षण करना चाहिए?

तय उदाहरणों में मान्य रिकॉर्ड, अनुपलब्ध या विकृत फ़ील्ड, स्रोत में अस्पष्ट मान, रीट्राई योग्य त्रुटियाँ और समीक्षक की अस्वीकृति शामिल करें। परीक्षण चलाने से पहले अपेक्षित परिणाम और पास होने की शर्तें तय करें।

क्या स्कीमा जाँच में सफल होने के तुरंत बाद निष्कर्षण वर्कफ़्लो डेटा लिख सकता है?

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

संबंधित लेख

Guides

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

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

阅读全文 →

Guides

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

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

阅读全文 →

Guides

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

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

阅读全文 →

Guides

रिपॉज़िटरी बदलावों, सत्यापन और मानवीय समीक्षा के लिए भरोसेमंद n8n वर्कफ़्लो बनाएँ

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

阅读全文 →