Make.com Connector
किसी भी सिनेरियो में एक ही Make मॉड्यूल डालें, पिछले स्टेप से एक एंटिटी मैप करें, और एक स्ट्रक्चर्ड, स्कीमा-वैलिडेटेड, मल्टी-मॉडल-फ्यूज़्ड JSON ऑब्जेक्ट पाएँ — साथ में 40 भाषाओं में बहुभाषी आउटपुट, जो एक ही LLM पास में तैयार होता है। डायनामिक ड्रॉपडाउन और प्लान-लिमिट को समझने वाली एरर हैंडलिंग के साथ 15 फ़र्स्ट-क्लास मॉड्यूल, जो Make के प्रति-ऑपरेशन बिलिंग मॉडल के लिए डिज़ाइन किए गए हैं।
Make के लिए डिज़ाइन किया गया
Entity Enricher पहले से ही एक n8n connector के साथ आता है जो Server-Sent Events स्ट्रीम को कंज़्यूम करता है। Make मॉड्यूल मूल रूप से SSE कंज़्यूम नहीं कर सकते — प्रत्येक मॉड्यूल एक एटॉमिक HTTP कॉल होता है। enrichment को एकल Make ऑपरेशन के रूप में सपोर्ट करने के लिए, बैकएंड एक समर्पित POST /api/single/enrich/sync एंडपॉइंट प्रदान करता है जो स्ट्रीमिंग फ़्लो को सर्वर-साइड रैप करता है और एक ही रिस्पॉन्स में अंतिम fused परिणाम लौटाता है।
एक ही पास में बहुभाषी संवर्धन
Languages फ़ील्ड में एक से अधिक भाषा चुनें और Entity Enricher हर बहुभाषी प्रॉपर्टी को एक ही LLM कॉल में सभी चयनित भाषाओं में भरता है — प्रति भाषा N क्रमिक राउंड-ट्रिप नहीं। 40 भाषाएँ प्रमुख यूरोपीय, एशियाई, मध्य-पूर्वी और अफ़्रीकी बाज़ारों को कवर करती हैं।
languages = ["en", "fr", "de", "ja"] के साथ एक Enrich Entity कॉल का परिणाम:
{
"names": {
"primary": {
"en": "Aspirin",
"fr": "Aspirine",
"de": "Aspirin",
"ja": "アスピリン"
}
},
"indications": {
"en": "Pain, fever, inflammation; antiplatelet therapy.",
"fr": "Douleur, fièvre, inflammation ; antiagrégant plaquettaire.",
"de": "Schmerz, Fieber, Entzündung; Thrombozytenaggregationshemmer.",
"ja": "痛み、発熱、炎症;抗血小板療法。"
}
}डाउनस्ट्रीम Make मॉड्यूल किसी भी भाषा को सीधे मैप कर सकते हैं: {{enrichEntity.result.names.primary.fr}}। Languages ड्रॉपडाउन पूरी 40-भाषा सूची दिखाता है, और जब आपके संगठन का प्रोफ़ाइल चयन योग्य भाषाओं की संख्या सीमित करता है तो एक प्लान-सीमा सूचना दिखाई जाती है।
इंस्टॉलेशन
Make ऐप का सोर्स सार्वजनिक TOT-Concept रिपॉज़िटरी में है (Entity Enricher मोनोरेपो से सिंक किया गया)। जब तक ऐप Make मार्केटप्लेस पर नहीं आ जाता, तब तक इसे Developer Hub से साइडलोड करें:
- एक डेवलपर के रूप में अपने Make संगठन में साइन इन करें।
- Apps → Create a new app → Custom App पर जाएँ।
- या तो
make-app-entity-enricher/डायरेक्टरी को.zipके रूप में अपलोड करें, या प्रत्येक.json/.imljsonफ़ाइल को एडिटर में उसके टैब में पेस्ट करें। - एक कनेक्शन जोड़ें — या तो Entity Enricher → Settings → API Keys से ली गई key का उपयोग करते हुए एक API Key connection (प्रारूप
ent_XXXXXXXXXXXX,/api/enrichment/optionsके विरुद्ध स्वतः परीक्षित), या फिर एक OAuth 2.0 connection: Entity Enricher में साइन इन करें और Authorize पर क्लिक करें।
डायनामिक ड्रॉपडाउन
Make मॉड्यूल में हर चयन योग्य फ़ील्ड एक RPC द्वारा भरा जाता है जो कॉन्फ़िगरेशन समय पर Entity Enricher API को हिट करता है। पिन किए गए स्कीमा पहले दिखते हैं (📌 से चिह्नित), मॉडल लेबल में प्रति-मिलियन-टोकन मूल्य शामिल होता है, और प्लान-सीमित संगठनों को उनका कोटा पहुँचने पर एक सूचना दिखती है।
पूर्वापेक्षाएँ
https://entityenricher.ai होता है। केवल सेल्फ-होस्टेड डिप्लॉयमेंट के लिए ओवरराइड करें।एक्शन में Enrich Entity
सेंट्रल मॉड्यूल अपने इनपुट फ़ील्ड डायनामिक ड्रॉपडाउन के साथ प्रस्तुत करता है: स्कीमा, मॉडल (मल्टी-सेलेक्ट), भाषाएँ (मल्टी-सेलेक्ट), स्ट्रैटेजी, वैकल्पिक क्लासिफिकेशन और आर्बिट्रेशन मॉडल, वेब सर्च, रिस्पॉन्स स्कीमा, स्ट्रिक्ट स्ट्रक्चर्ड आउटपुट, टाइमआउट, और मेटाडेटा टॉगल। Entity data फ़ील्ड के माध्यम से किसी भी पिछले मॉड्यूल से एंटिटी मैप करें।
जब 2+ मॉडल चुने जाते हैं, तो परिणाम स्वतः सर्वर-साइड फ्यूज़ हो जाता है। Make आउटपुट पैनल is_fused: true, source_models की सूची, और सहमत तथा विरोधाभासी फ़ील्ड गिनने वाला fusion सारांश दिखाता है:
identity_merges— हर वह बार जब इस रन ने किसी मौजूदा पहचान का पुन: उपयोग किया जो अलग शब्दों से बनी थी, साथ में वह समानता जिसने इसे तय किया (जब किसी सटीक कोड या टोकन मिलान ने फ़ैसला किया हो तो यह खाली रहता है, क्योंकि तब कोई समानता मापी ही नहीं गई)।entity_keys— वास्तव में संग्रहीत key कॉलम मान, ताकि कोई डाउनस्ट्रीम मॉड्यूल अभी-अभी बनाई गई पंक्ति को बिना अनुमान लगाए संबोधित कर सके।- एक डेटाबेस-राइट
statusजो partial राइट को सीधे सफलता बताने के बजाय ईमानदारी से रिपोर्ट करता है, साथ मेंskipped_itemsऔरkey_collisionsभी। - रिकॉर्ड पर:
retries, जिसने पुरानेattemptsफ़ील्ड की जगह ली — यह एक ब्रेकिंग नाम-परिवर्तन है, इसलिए इसे मैप करने वाले हर सिनैरियो को अपडेट करें।
उपलब्ध मॉड्यूल
7 श्रेणियों में 15 मॉड्यूल। Search मॉड्यूल डाउनस्ट्रीम Iterator/Aggregator चेन के लिए प्रति परिणाम एक bundle देते हैं; Action मॉड्यूल एक ही bundle देते हैं।
| श्रेणी | मॉड्यूल | विवरण |
|---|---|---|
| Enrichment | Enrich Entity | मल्टी-मॉडल फ्यूज़न के साथ सिंगल-कॉल एनरिचमेंट। अंतिम फ्यूज़्ड (या बेस्ट-सिंगल-मॉडल) परिणाम लौटाता है। क्लासिफिकेशन चेतावनी पर स्वतः रद्द हो जाता है। |
| Schemas | List Schemas | प्रत्येक सहेजे गए schema के लिए एक Make bundle लौटाता है, जो Iterator/Aggregator चेन के लिए तैयार है। |
| Schemas | Get Schema Details | विशेषज्ञता डोमेन, प्रॉपर्टीज़ और सर्च कीज़ सहित पूरा स्कीमा कंटेंट। |
| Schemas | Generate Sample | एक ही ब्लॉकिंग कॉल में एक एंटिटी प्रकार के 1..N वास्तविक नमूना JSON ऑब्जेक्ट जनरेट करें — स्कीमा ऑथरिंग का प्रवेश बिंदु। पहला नमूना फ़ील्ड सेट को परिभाषित करता है; बाकी समान-फ़ील्ड वाले इंस्टेंस वैरिएंट होते हैं। |
| Schemas | Generate Schema | समान एंटिटी प्रकार के 1..N नमूना ऑब्जेक्ट से एक JSON स्कीमा जनरेट करें और अपने-आप सेव करें — फ़ील्ड का यूनियन, जहाँ किसी नमूने में कोई फ़ील्ड गायब हो वहाँ nullable, और उदाहरण के रूप में वास्तविक अवलोकित मान। |
| Records | List Records | फ़िल्टर (टाइप, सफलता, फ्री-टेक्स्ट) के साथ पिछले संवर्धन रिकॉर्ड खोजें। |
| Records | Get Record | पूर्ण प्रति-prompt मेट्रिक्स के साथ एकल enrichment परिणाम प्राप्त करें। |
| Records | Inject Records into Database | संग्रहीत (या रूपांतरित) एनरिचमेंट आउटपुट को उसके स्कीमा के database sync पर भेजें। स्कीमा के प्रकाशित कॉन्ट्रैक्ट के विरुद्ध दोबारा सत्यापित, फिर एडमिशन गेट से गुज़ारा गया। |
| Fusion | Merge Results | कई एनरिचमेंट परिणामों को फिर से मर्ज करें, वैकल्पिक रूप से किसी भिन्न LLM आर्बिटर के साथ। |
| Attachments | Upload Attachment | एक फ़ाइल अपलोड करें (किसी अपस्ट्रीम मॉड्यूल से buffer के रूप में मैप की गई, जैसे HTTP ▸ Get a File) और Enrich Entity में उपयोग के लिए उसका attachment ID लौटाएँ। |
| Attachments | Delete Attachment | ID द्वारा एक attachment हटाएँ — enrichment के बाद सफ़ाई का एक सुविधाजनक चरण। |
| Database Sync | List Database Syncs | किसी स्कीमा के database sync लौटाता है, लंबित डेल्टा गिनती के साथ। |
| Database Sync | Fetch Database Deltas | किसी database sync के लिए SQL डेल्टा की अगली FIFO विंडो लौटाता है। Claim सक्षम होने पर पंक्तियाँ लीज़ पर ली जाती हैं और उन्हें स्वीकार करना ज़रूरी होता है; अन्यथा रीड को दोबारा चलाया जा सकता है। |
| Database Sync | Acknowledge Database Deltas | किसी ID तक लागू किए गए डेल्टा को स्वीकार करता है — यह लीज़ को रिलीज़ करता है और, sync विकल्पों के अनुसार, डिलीवर की गई प्रतियाँ हटा देता है। |
| Configuration | Get Options | उपलब्ध मॉडल, भाषाएँ, स्ट्रैटेजी, और org की प्लान सीमाएँ। |
Database Sync मॉड्यूल किसी शेड्यूल किए गए सिनेरियो से database sync डेल्टा फ़ीड चलाते हैं: Fetch Database Deltas अगली SQL विंडो लीज़ पर लेता है, कोई डेटाबेस या HTTP मॉड्यूल उसे लागू करता है, और Acknowledge Database Deltas उसकी पुष्टि करता है (Fetch के Next Cursor को Acknowledge में मैप करें)।
मल्टी-एंटिटी वर्कफ़्लो: इटरेटर पैटर्न
Make scenarios प्रति ऑपरेशन बिल किए जाते हैं। n8n कनेक्टर के Batch Enrich मॉड्यूल को पोर्ट करने के बजाय, Make ऐप Make के बिल्ट-इन Iterator + Enrich Entity का उपयोग करता है। हर iteration स्वतंत्र होता है, विफलताएँ कैस्केड नहीं होतीं, और बिलिंग ठीक वही दर्शाती है जो प्रोसेस किया गया।
प्रमुख विशेषताएँ
40 भाषाओं में बहुभाषी
एक अकेला Enrich Entity कॉल सभी चयनित भाषाओं में हर बहुभाषी प्रॉपर्टी को पॉप्युलेट करता है — एक ही LLM पास में तैयार, N क्रमिक राउंड-ट्रिप में नहीं। किसी भी भाषा को सीधे मैप करें: {{result.names.primary.fr}}।
वन-कॉल Enrichment
एक समर्पित POST /api/single/enrich/sync endpoint streaming प्रवाह को server-side लपेटता है। एक Make ऑपरेशन = एक bundle। कोई polling नहीं, कोई two-module पैटर्न नहीं।
डिफ़ॉल्ट रूप से Simple
Enrich Entity मॉड्यूल केवल entity डेटा, schema, भाषाओं, और वेब सर्च के साथ खुलता है — Entity Enricher आपके organization के सबसे बेहतर model के साथ अपने-आप चलता है। Models, attachments, रणनीति, और classification/arbitration विकल्प Make के "Show advanced settings" टॉगल के पीछे मौजूद रहते हैं।
डायनामिक ड्रॉपडाउन (RPCs)
10 RPC कॉन्फ़िगरेशन के समय स्कीमा, database syncs, मॉडल, भाषाएँ, रणनीतियाँ, वर्गीकरण/आर्बिट्रेशन मॉडल, response-schema और structured-output विकल्प लाते हैं — पिन किए गए स्कीमा पहले दिखते हैं, और मॉडल लेबल में क़ीमत शामिल होती है।
मल्टी-मॉडल ऑटो-फ्यूज़न
2 या अधिक model चुनें और परिणाम स्वतः fusion हो जाता है। आउटपुट बंडल में is_fused, source_models[], और एक fusion: {agreed_fields, conflicted_fields, total_fields, method, arbitration_model} सारांश शामिल होता है।
प्री-फ्लाइट क्लासिफिकेशन
एक वैकल्पिक सस्ता क्लासिफायर मॉडल एनरिचमेंट चलने से पहले यह सत्यापित करता है कि एंटिटी स्कीमा के अपेक्षित प्रकार से मेल खाती है। असंगतियाँ मनगढ़ंत डेटा के बजाय एक टाइप्ड DataError उत्पन्न करती हैं।
प्लान-सीमा और Credit जानकारी
HTTP 402 त्रुटियाँ (प्लान सीमाएँ या अपर्याप्त क्रेडिट) टाइप्ड Make OutOfMoneyError बन जाती हैं। संदेश बैकएंड का मानव-पठनीय विवरण दोहराता है (क्रेडिट खत्म होने पर बिलिंग टॉप-अप URL के साथ) और साथ में एक मशीन-पठनीय कोड — कोड के आधार पर सिनेरियो error handler को ब्रांच करें ताकि लोगों को अलर्ट करें, सस्ते मॉडल पर फ़ॉलबैक करें, या रोक दें।
वेब-सर्च ड्रॉपडाउन लॉक
Web Search ड्रॉपडाउन parameters.models को पढ़ता है और तब खुद को अक्षम कर देता है जब चयनित मॉडलों में से कोई भी supports_web_search घोषित नहीं करता।
कोई Batch मॉड्यूल नहीं
Make scenarios प्रति ऑपरेशन बिल किए जाते हैं। मल्टी-entity वर्कफ़्लो Make के बिल्ट-इन Iterator + Enrich Entity का उपयोग करते हैं, जो प्रति-entity ग्रैन्युलर त्रुटि हैंडलिंग और सटीक बिलिंग देते हैं।
कॉन्फ़िगरेबल टाइमआउट
प्रति कॉल डिफ़ॉल्ट 300-सेकंड टाइमआउट, सीमा [10, 900]। यदि जॉब समय पर पूरा नहीं होता, तो इसे सर्वर-साइड पर स्वतः रद्द कर दिया जाता है, और एक टाइप्ड ConnectionError लौटाया जाता है।
त्रुटि अनुबंध
बैकएंड जो भी स्थिति लौटा सकता है उसे एक टाइप्ड Make एरर से मैप किया जाता है ताकि परिदृश्य एरर हैंडलर स्ट्रिंग्स पार्स करने के बजाय विफलता मोड पर ब्रांच कर सकें।
| HTTP | Make त्रुटि प्रकार | यह कब फायर होता है |
|---|---|---|
| 400 | DataError | स्कीमा नहीं मिला, सर्च की गायब हैं, अमान्य मॉडल या भाषाएँ। |
| 401 | InvalidCredentials | गलत या गुम API की। |
| 402 | OutOfMoneyError | प्लान सीमा पार हो गई या अपर्याप्त credit। संदेश = body.detail.detail (मानव-पठनीय, insufficient_credits के लिए एक टॉप-अप URL शामिल है) + body.detail.code (मशीन-पठनीय)। code के आधार पर ब्रांच करें: insufficient_credits, model_limit_exceeded, language_limit_exceeded, concurrent_job_limit_reached, daily/weekly/monthly_prompt_limit_exceeded। |
| 403 | AccessDeniedError | भूमिका या स्कोप अपर्याप्त है। |
| 404 | InvalidConfigurationError | स्कीमा या रिकॉर्ड नहीं मिला। |
| 422 | DataError | क्लासिफिकेशन चेतावनी। body.detail.classification में status, reasoning, confidence, entity_description होते हैं। |
| 429 | RateLimitError | प्रोवाइडर रेट लिमिट (अस्थायी)। |
| 499 | RuntimeError | Job रद्द किया गया। |
| 502 | ConnectionError | अपस्ट्रीम LLM प्रोवाइडर त्रुटि (जैसे संदर्भ ओवरफ़्लो)। |
| 504 | ConnectionError | timeout_seconds बीत गए; जॉब सर्वर-साइड पर स्वतः रद्द हो गई। |
किसी उदाहरण सिनैरियो से शुरू करें
ऐप में छह इम्पोर्ट करने योग्य सिनेरियो ब्लूप्रिंट आते हैं — सिंगल संवर्धन, Iterator बैच पैटर्न, दस्तावेज़ से संवर्धन, इमेज से सैंपल से स्कीमा, सैंपल से स्कीमा, और किसी database sync की डेल्टा फ़ीड को खाली करना। मॉड्यूल शुरू से जोड़ने के बजाय कोई एक इम्पोर्ट करें और उसमें अपना कनेक्शन लगा दें।