n8n कनेक्टर - Entity Enricher दस्तावेज़

n8n कनेक्टर

n8n के लिए Entity Enricher कम्युनिटी नोड आपको विज़ुअल ड्रैग-एंड-ड्रॉप एडिटर के साथ स्वचालित एनरिचमेंट पाइपलाइन बनाने देता है। बिना कोड लिखे 400+ ऐप्स से कनेक्ट करें।

इंस्टॉलेशन

अपने n8n इंस्टेंस में कम्युनिटी नोड इंस्टॉल करें:

npm install n8n-nodes-entity-enricher

या n8n UI के माध्यम से इंस्टॉल करें: Settings → Community Nodes पर जाएँ और n8n-nodes-entity-enricher खोजें।

पूर्वापेक्षाएँ

API कुंजीEntity Enricher में एक organization एक्सेस की बनाएँ। विवरण के लिए API Keys दस्तावेज़ देखें। की का प्रारूप ent_XXXXXXXXXXXX है।
बेस URLआपके Entity Enricher इंस्टेंस का URL (जैसे, https://entityenricher.ai या आपका सेल्फ-होस्टेड URL)।
क्रेडेंशियल सेटअपn8n में, अपनी API key और base URL के साथ एक Entity Enricher API credential बनाएँ। सभी nodes इस credential का उपयोग करेंगे।

उपलब्ध ऑपरेशन

कनेक्टर 6 रिसोर्स श्रेणियों में 10 ऑपरेशन प्रस्तुत करता है:

रिसोर्सऑपरेशनविवरण
EnrichmentEnrich Entityएक या अधिक AI model के साथ एकल entity को एनरिच करें। SSE के माध्यम से रियल-टाइम प्रगति के साथ परिणाम स्ट्रीम करता है।
EnrichmentBatch Enrichसभी इनपुट आइटम को एकल batch के रूप में एनरिच करें। प्रति-entity प्रगति ट्रैकिंग के साथ समानांतर प्रोसेसिंग।
SchemaList Schemasसंवर्धन वर्कफ़्लो में चयन के लिए उपलब्ध सहेजे गए स्कीमा की सूची बनाएँ।
SchemaGet Schema Detailsकिसी विशिष्ट schema के लिए निकाली गई मुख्य प्रॉपर्टीज़ के साथ पूर्ण schema सामग्री प्राप्त करें।
RecordList Recordsटाइप और सफलता फ़िल्टर के साथ enrichment record क्वेरी करें। पेजिनेटेड परिणाम।
RecordGet Recordपूर्ण संरचित आउटपुट के साथ ID द्वारा एक विशिष्ट enrichment परिणाम प्राप्त करें।
FusionMerge Resultsवैकल्पिक LLM आर्बिट्रेशन के साथ कई संवर्धन रिकॉर्ड के परिणामों को फ्यूज़ करें।
AttachmentAdd Attachmentइनपुट आइटम से एक binary property अपलोड करें (multipart) और उसका attachment ID लौटाएँ।
AttachmentDelete AttachmentID द्वारा एक attachment हटाएँ — enrichment के बाद सफ़ाई का एक सुविधाजनक चरण।
ConfigurationGet Optionsडायनामिक कॉन्फ़िगरेशन के लिए उपलब्ध मॉडल, भाषाएँ, स्ट्रैटेजी और प्लान सीमाएँ फ़ेच करें।

सिंगल एंटिटी एनरिचमेंट

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

उदाहरण वर्कफ़्लो — एकल एंटिटी संवर्धन:

नोड कॉन्फ़िगरेशन — एनरिच एंटिटी ऑपरेशन:

एकल संवर्धन के लिए Entity Enricher नोड कॉन्फ़िगरेशन

कॉन्फ़िगरेशन

डायनामिक ड्रॉपडाउन से एक schema चुनें, एक या अधिक models चुनें, और entity डेटा को key-value फ़ील्ड के रूप में प्रदान करें। नोड चयनित schema के आधार पर search key फ़ील्ड स्वतः भर देता है।

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

स्रोत दस्तावेज़ों को एनरिचमेंट में देने के लिए एक अटैचमेंट ID फ़ील्ड दें (पिछले Add Attachment कॉल से कॉमा-सेपरेटेड UUID) — यह Batch Enrich पर भी उपलब्ध है।

बैच एनरिचमेंट

सभी इनपुट आइटम्स को एक ही batch के रूप में प्रोसेस करें। स्प्रेडशीट, डेटाबेस या API प्रतिक्रियाओं की सूचियों को enrich करने के लिए आदर्श। सभी entities प्रति-provider रेट लिमिटिंग के साथ समानांतर में प्रोसेस होती हैं।

नोड कॉन्फ़िगरेशन — बैच एनरिच ऑपरेशन:

बैच संवर्धन के लिए Entity Enricher नोड कॉन्फ़िगरेशन

बैच मोड कैसे काम करता है

  1. आइटम एकत्र करें — नोड पिछले नोड से सभी इनपुट आइटम एकत्र करता है (उदा., स्प्रेडशीट की पंक्तियाँ)।
  2. बैच जॉब शुरू करें — सभी एंटिटीज़ को POST /api/batch/start के माध्यम से सबमिट किया जाता है और समानांतर में प्रोसेस किया जाता है।
  3. प्रगति स्ट्रीम करें — नोड SSE स्ट्रीम का उपभोग तब तक करता है जब तक सभी एंटिटीज़ पूरी नहीं हो जातीं या टाइमआउट नहीं पहुँच जाता।
  4. आउटपुट परिणाम — प्रति एंटिटी एक आउटपुट आइटम, एनरिच किए गए संरचित डेटा के साथ, डाउनस्ट्रीम प्रोसेसिंग के लिए तैयार।

प्रमुख विशेषताएँ

डायनामिक ड्रॉपडाउन

Schema, model, भाषा और रणनीति चयनकर्ता कॉन्फ़िगरेशन के समय आपके Entity Enricher इंस्टेंस से विकल्प प्राप्त करते हैं।

SSE स्ट्रीमिंग

संवर्धन ऑपरेशन SSE स्ट्रीम को रियल-टाइम में उपभोग करते हैं, अगले नोड को परिणाम लौटाने से पहले पूर्ण होने की प्रतीक्षा करते हैं।

ऑटो-कंटिन्यू

जब प्री-फ़्लाइट क्लासिफिकेशन कोई बेमेल पहचानता है, तो कनेक्टर स्वतः जारी रहता है (n8n वर्कफ़्लो नॉन-इंटरैक्टिव होते हैं)।

कॉन्फ़िगरेबल टाइमआउट

प्रति एनरिचमेंट कॉल डिफ़ॉल्ट 300-सेकंड टाइमआउट, बड़े स्कीमा या धीमे मॉडल के लिए प्रति नोड समायोज्य।

मल्टी-मॉडल समर्थन

प्रति enrichment कई models चुनें। जब 2+ models का उपयोग किया जाता है, तो परिणाम स्वतः fuse हो जाते हैं।

डिफ़ॉल्ट रूप से आउटपुट साफ़ करें

डिफ़ॉल्ट रूप से, आउटपुट में केवल enrich किए गए डेटा फ़ील्ड होते हैं। लागत, टोकन, fusion विवरण और record ID जोड़ने के लिए "Include Enrichment Metadata" को टॉगल करें।

प्रति-model आउटपुट

डाउनस्ट्रीम तुलना के लिए वैकल्पिक रूप से फ्यूज़ किए गए परिणाम के साथ-साथ अलग-अलग मॉडल परिणाम आउटपुट करें।

प्लान सीमा की जानकारी

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

Workflow आइडियाज़

n8n के साथ enrichment पाइपलाइन बनाने के सामान्य पैटर्न:

CRM enrichmentनए HubSpot/Salesforce संपर्कों पर ट्रिगर करें, कंपनी डेटा के साथ एनरिच करें, CRM रिकॉर्ड अपडेट करें।
स्प्रेडशीट पाइपलाइनGoogle Sheets से एंटिटीज़ पढ़ें, बैच एनरिच करें, परिणाम वापस एक नई शीट में लिखें।
Waterfall Enrichmentकंडीशनल लॉजिक के साथ कई एनरिचमेंट चरणों को जोड़ें — पहले एक तेज़ मॉडल का उपयोग करें, विफलताओं को अधिक सक्षम मॉडल से फिर से एनरिच करें।
शेड्यूल्ड रिफ्रेशपुराने रिकॉर्ड को नवीनतम AI मॉडल के साथ फिर से एनरिचमेंट करने के लिए क्रॉन शेड्यूल पर चलाएँ।
वेबहुक-संचालितएक webhook एंडपॉइंट एक्सपोज़ करें जो एंटिटी डेटा स्वीकार करता है, उसे संवर्धित करता है, और परिणाम सिंक्रोनस रूप से लौटाता है।

अगले चरण