Make.com Connector - Entity Enricher दस्तावेज़ीकरण

Make.com Connector

किसी भी सिनारियो में एक Make मॉड्यूल ड्रॉप करें, पिछले चरण से एक एंटिटी मैप करें, और एक संरचित, स्कीमा-सत्यापित, मल्टी-मॉडल-फ्यूज़्ड JSON ऑब्जेक्ट प्राप्त करें — जिसमें 40 भाषाओं में बहुभाषी आउटपुट एक ही LLM पास में तैयार होता है। डायनामिक ड्रॉपडाउन और प्लान-सीमा-जागरूक एरर हैंडलिंग के साथ 9 फर्स्ट-क्लास मॉड्यूल, जो Make के प्रति-ऑपरेशन बिलिंग मॉडल के लिए डिज़ाइन किए गए हैं।

Make के लिए डिज़ाइन किया गया

Entity Enricher पहले से ही एक n8n connector के साथ आता है जो Server-Sent Events स्ट्रीम को कंज़्यूम करता है। Make मॉड्यूल मूल रूप से SSE कंज़्यूम नहीं कर सकते — प्रत्येक मॉड्यूल एक एटॉमिक HTTP कॉल होता है। enrichment को एकल Make ऑपरेशन के रूप में सपोर्ट करने के लिए, बैकएंड एक समर्पित POST /api/single/enrich/sync एंडपॉइंट प्रदान करता है जो स्ट्रीमिंग फ़्लो को सर्वर-साइड रैप करता है और एक ही रिस्पॉन्स में अंतिम fused परिणाम लौटाता है।

n8n connector

POST /enrich/stream → job_id

GET /llm/stream/{id}

... (events)

[final bundle out]

Make.com connector

POST /enrich/sync

(server awaits internally)

[final bundle out]

एक ही पास में बहुभाषी संवर्धन

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 मॉड्यूल: 40 समर्थित भाषाएँ दिखाने वाला भाषाओं का मल्टी-सेलेक्ट ड्रॉपडाउन

इंस्टॉलेशन

Make ऐप का सोर्स public TOT-Concept repository में है (Entity Enricher मोनोरेपो से सिंक किया गया)। जब तक v1.0 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)। यह connection स्वतः /api/enrichment/options के विरुद्ध टेस्ट होता है।

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

Make मॉड्यूल में हर चयन योग्य फ़ील्ड एक RPC द्वारा भरा जाता है जो कॉन्फ़िगरेशन समय पर Entity Enricher API को हिट करता है। पिन किए गए स्कीमा पहले दिखते हैं (📌 से चिह्नित), मॉडल लेबल में प्रति-मिलियन-टोकन मूल्य शामिल होता है, और प्लान-सीमित संगठनों को उनका कोटा पहुँचने पर एक सूचना दिखती है।

Make मॉड्यूल: शीर्ष पर पिन किए गए schemas के साथ खुला Schemas ड्रॉपडाउन

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

API कुंजी— Entity Enricher में एक organization एक्सेस की बनाएँ। API Keys दस्तावेज़ देखें। सर्विस-टू-सर्विस इंटीग्रेशन के लिए organization एक्सेस की (अपनी अलग भूमिका के साथ) का उपयोग करें।

बेस URL— आपके Entity Enricher इंस्टेंस का URL — डिफ़ॉल्ट रूप से https://entityenricher.ai होता है। केवल सेल्फ-होस्टेड डिप्लॉयमेंट के लिए ओवरराइड करें।

OAuth 2.0— v0.4 में API-key auth के साथ आ रहा है, जैसे ही Entity Enricher का प्राधिकरण सर्वर उपलब्ध होगा। एंड-यूज़र scenarios मानक Make OAuth फ़्लो के ज़रिए अपने खुद के अकाउंट कनेक्ट कर सकेंगे।

एक्शन में Enrich Entity

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

जब 2+ मॉडल चुने जाते हैं, तो परिणाम स्वतः सर्वर-साइड फ्यूज़ हो जाता है। Make आउटपुट पैनल is_fused: true, source_models की सूची, और सहमत तथा विरोधाभासी फ़ील्ड गिनने वाला fusion सारांश दिखाता है:

Make आउटपुट पैनल: मल्टी-मॉडल fused enrichment परिणाम

उपलब्ध मॉड्यूल

5 श्रेणियों में 9 module। Search module प्रत्येक परिणाम के लिए एक bundle उत्सर्जित करते हैं ताकि downstream Iterator/Aggregator chain बन सकें; Action module एक ही bundle उत्सर्जित करते हैं।

श्रेणी	मॉड्यूल	विवरण
Enrichment	Enrich Entity	मल्टी-मॉडल फ्यूज़न के साथ सिंगल-कॉल एनरिचमेंट। अंतिम फ्यूज़्ड (या बेस्ट-सिंगल-मॉडल) परिणाम लौटाता है। क्लासिफिकेशन चेतावनी पर स्वतः रद्द हो जाता है।
Schemas	List Schemas	प्रत्येक सहेजे गए schema के लिए एक Make bundle लौटाता है, जो Iterator/Aggregator चेन के लिए तैयार है।
Schemas	Get Schema Details	विशेषज्ञता डोमेन, प्रॉपर्टीज़ और सर्च कीज़ सहित पूरा स्कीमा कंटेंट।
Records	List Records	फ़िल्टर (टाइप, सफलता, फ्री-टेक्स्ट) के साथ पिछले संवर्धन रिकॉर्ड खोजें।
Records	Get Record	पूर्ण प्रति-prompt मेट्रिक्स के साथ एकल enrichment परिणाम प्राप्त करें।
Fusion	Merge Results	कई एनरिचमेंट परिणामों को फिर से मर्ज करें, वैकल्पिक रूप से किसी भिन्न LLM आर्बिटर के साथ।
Attachments	Upload Attachment	एक फ़ाइल अपलोड करें (किसी अपस्ट्रीम मॉड्यूल से buffer के रूप में मैप की गई, जैसे HTTP ▸ Get a File) और Enrich Entity में उपयोग के लिए उसका attachment ID लौटाएँ।
Attachments	Delete Attachment	ID द्वारा एक attachment हटाएँ — enrichment के बाद सफ़ाई का एक सुविधाजनक चरण।
Configuration	Get Options	उपलब्ध मॉडल, भाषाएँ, स्ट्रैटेजी, और org की प्लान सीमाएँ।

मल्टी-एंटिटी वर्कफ़्लो: इटरेटर पैटर्न

Make scenarios प्रति ऑपरेशन बिल किए जाते हैं। n8n कनेक्टर के Batch Enrich मॉड्यूल को पोर्ट करने के बजाय, Make ऐप Make के बिल्ट-इन Iterator + Enrich Entity का उपयोग करता है। हर iteration स्वतंत्र होता है, विफलताएँ कैस्केड नहीं होतीं, और बिलिंग ठीक वही दर्शाती है जो प्रोसेस किया गया।

[trigger: array of entities]

↓

[Make: Iterator] (splits into N bundles)

↓

[this app: Enrich Entity] (one operation per entity)

↓

[Make: Aggregator] (recombines, optionally with skip-on-error)

↓

[downstream: upsert to CRM / database]

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

40 भाषाओं में बहुभाषी

एक अकेला Enrich Entity कॉल सभी चयनित भाषाओं में हर बहुभाषी प्रॉपर्टी को पॉप्युलेट करता है — एक ही LLM पास में तैयार, N क्रमिक राउंड-ट्रिप में नहीं। किसी भी भाषा को सीधे मैप करें: {{result.names.primary.fr}}।

वन-कॉल Enrichment

एक समर्पित POST /api/single/enrich/sync endpoint streaming प्रवाह को server-side लपेटता है। एक Make ऑपरेशन = एक bundle। कोई polling नहीं, कोई two-module पैटर्न नहीं।

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

7 RPC कॉन्फ़िगरेशन के समय स्कीमा, मॉडल, भाषाएँ, रणनीतियाँ, वर्गीकरण/आर्बिट्रेशन मॉडल और वेब-सर्च विकल्प प्राप्त करते हैं — पिन किए गए स्कीमा पहले दिखते हैं, मॉडल लेबल में मूल्य निर्धारण शामिल होता है।

मल्टी-मॉडल ऑटो-फ्यूज़न

2 या अधिक model चुनें और परिणाम स्वतः fusion हो जाता है। आउटपुट बंडल में is_fused, source_models[], और एक fusion: {agreed_fields, conflicted_fields, total_fields} सारांश शामिल होता है।

प्री-फ्लाइट क्लासिफिकेशन

एक वैकल्पिक सस्ता क्लासिफायर मॉडल एनरिचमेंट चलने से पहले यह सत्यापित करता है कि एंटिटी स्कीमा के अपेक्षित प्रकार से मेल खाती है। असंगतियाँ मनगढ़ंत डेटा के बजाय एक टाइप्ड 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 एरर से मैप किया जाता है ताकि परिदृश्य एरर हैंडलर स्ट्रिंग्स पार्स करने के बजाय विफलता मोड पर ब्रांच कर सकें।

Make scenario: OutOfMoneyError पर ब्रांचिंग करने वाला त्रुटि हैंडलर

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 बीत गए; जॉब सर्वर-साइड पर स्वतः रद्द हो गई।

Workflow आइडियाज़

CRM enrichment— नए HubSpot/Salesforce संपर्कों पर ट्रिगर करें, कंपनी डेटा के साथ एनरिच करें, CRM रिकॉर्ड अपडेट करें।

स्प्रेडशीट पाइपलाइन— Google Sheets से एंटिटीज़ पढ़ें, Iterator + Enrich Entity, परिणाम वापस एक नई शीट में लिखें।

शर्त-आधारित री-आर्बिट्रेशन— पहले नियम-आधारित फ्यूज़न चलाएँ; यदि conflicted_fields > 5 हो, तो महँगी एनरिचमेंट को फिर से चलाए बिना Merge Results के माध्यम से LLM आर्बिटर के साथ फिर से मर्ज करें।

प्लान-लिमिट रूटिंग— OutOfMoneyError पर, Slack में किसी व्यक्ति को अलर्ट करें और कोटा विंडो रीसेट होने तक scenario को रोक दें।

शेड्यूल्ड रिफ्रेश— पुराने रिकॉर्ड को नवीनतम मॉडल के साथ फिर से एनरिचमेंट करने के लिए क्रॉन शेड्यूल पर चलाएँ (Make Schedule ट्रिगर)।