Make.com-connector - Entity Enricher-documentatie

Make.com-connector

Zet één Make-module in een willekeurig scenario, wijs een entity toe uit een vorige stap en ontvang een gestructureerd, schema-gevalideerd, multi-model-gefuseerd JSON-object — met meertalige uitvoer in 40 talen die in één LLM-pass wordt geproduceerd. 9 eersteklas modules met dynamische dropdowns en foutafhandeling die rekening houdt met planlimieten, ontworpen voor het facturatiemodel per bewerking van Make.

Ontworpen voor Make

Entity Enricher wordt al geleverd met een n8n-connector die een Server-Sent Events-stream verwerkt. Make-modules kunnen SSE niet native verwerken — elke module is één atomaire HTTP-aanroep. Om verrijking als één Make-bewerking te ondersteunen, biedt de backend een speciaal POST /api/single/enrich/sync-eindpunt dat de streamingflow server-side omhult en het uiteindelijke gefuseerde resultaat in één response retourneert.

n8n connector
POST /enrich/stream → job_id
GET /llm/stream/{id}
GET /llm/stream/{id}
... (events)
[final bundle out]
Make.com connector
POST /enrich/sync
(server awaits internally)
[final bundle out]

Meertalige verrijking in één doorloop

Kies meer dan één taal in het veld Talen en Entity Enricher vult elke meertalige eigenschap in alle geselecteerde talen in één enkele LLM-aanroep — geen N opeenvolgende heen-en-weer-aanroepen per taal. 40 talen dekken de belangrijkste Europese, Aziatische, Midden-Oosterse en Afrikaanse markten.

Resultaat van één Enrich Entity-aanroep met languages = ["en", "fr", "de", "ja"]:

{
  "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": "痛み、発熱、炎症;抗血小板療法。"
  }
}

Downstream Make-modules kunnen elke taal rechtstreeks toewijzen: {{enrichEntity.result.names.primary.fr}}. Het Talen-dropdownmenu toont de volledige lijst met 40 talen, met een melding over de planlimiet wanneer het profiel van je organisatie het aantal selecteerbare talen beperkt.

Make-module: meervoudige selectielijst voor talen met 40 ondersteunde talen

Installatie

De broncode van de Make-app staat in de publieke TOT-Concept-repository (gesynchroniseerd vanuit de Entity Enricher-monorepo). Totdat v1.0 op de Make-marktplaats verschijnt, sideload je via de Developer Hub:

  1. Log als ontwikkelaar in op je Make-organisatie.
  2. Ga naar Apps → Create a new app → Custom App.
  3. Upload de map make-app-entity-enricher/ als een .zip, of plak elk .json- / .imljson-bestand in het bijbehorende tabblad in de editor.
  4. Voeg een API Key-verbinding toe met een sleutel uit Entity Enricher → Instellingen → API Keys (formaat ent_XXXXXXXXXXXX). De verbinding test automatisch tegen /api/enrichment/options.
Make: instelformulier voor API Key-verbinding

Dynamische dropdowns

Elk selecteerbaar veld in de Make-modules wordt gevuld door een RPC die tijdens de configuratie de Entity Enricher API aanroept. Vastgezette schema's verschijnen eerst (gemarkeerd met 📌), modellabels bevatten prijzen per miljoen tokens, en organisaties met een planlimiet zien een melding zodra hun quota is bereikt.

Make-module: geopende schema's-vervolgkeuzelijst met vastgemaakte schema's bovenaan

Vereisten

API-sleutelMaak een organization-toegangssleutel aan in Entity Enricher. Zie de documentatie over API-sleutels. Gebruik een organization-toegangssleutel (met zijn eigen rol) voor service-naar-service-integraties.
Basis-URLDe URL van je Entity Enricher-instance — standaard https://entityenricher.ai. Overschrijf dit alleen voor zelf-gehoste implementaties.
OAuth 2.0Komt in v0.4 samen met API-sleutelverificatie, zodra de autorisatieserver van Entity Enricher beschikbaar is. Eindgebruikersscenario's kunnen dan hun eigen accounts koppelen via de standaard Make OAuth-flow.

Entiteit verrijken in actie

De centrale module toont zijn invoervelden met dynamische dropdowns: schema, modellen (multiselectie), talen (multiselectie), strategie, optionele classificatie- en arbitragemodellen, webzoekopdracht, response-schema, strikte gestructureerde uitvoer, time-out en metadata-schakelaars. Koppel een entiteit vanuit een eerdere module via het veld Entity data.

Wanneer er 2+ modellen zijn geselecteerd, wordt het resultaat automatisch server-side gefuseerd. Het Make-uitvoerpaneel toont is_fused: true, de lijst met source_models en een fusion-samenvatting die overeenkomende en conflicterende velden telt:

Make-uitvoerpaneel: gefuseerd enrichment-resultaat van meerdere modellen

Beschikbare modules

9 modules verdeeld over 5 categorieën. Search-modules zenden één bundel per resultaat uit voor downstream Iterator/Aggregator-ketens; Action-modules zenden één enkele bundel uit.

CategorieModuleBeschrijving
EnrichmentEnrich EntityEnrichment met één aanroep en fusion van meerdere modellen. Geeft het uiteindelijke gefuseerde (of beste-enkele-model) resultaat terug. Annuleert automatisch bij een classification-waarschuwing.
SchemasList SchemasGeeft één Make-bundle terug per opgeslagen schema, klaar voor Iterator/Aggregator-ketens.
SchemasGet Schema DetailsVolledige schema-inhoud inclusief expertisedomeinen, eigenschappen en zoeksleutels.
RecordsList RecordsZoek eerdere verrijkingsrecords met filters (type, succes, vrije tekst).
RecordsGet RecordHaal één enkel enrichment-resultaat op met volledige metrics per prompt.
FusionMerge ResultsMeerdere verrijkingsresultaten opnieuw samenvoegen, optioneel met een andere LLM-arbiter.
AttachmentsUpload AttachmentUpload een bestand (toegewezen als buffer vanuit een upstream-module, bijv. HTTP ▸ Get a File) en ontvang de bijbehorende attachment-ID voor gebruik in Enrich Entity.
AttachmentsDelete AttachmentVerwijder een bijlage op ID — een handige opschoonstap na de verrijking.
ConfigurationGet OptionsBeschikbare models, talen, strategieën en de plan-limieten van de organization.

Werkstromen met meerdere entiteiten: iteratorpatroon

Make-scenario's rekenen per bewerking af. In plaats van de Batch Enrich-module van de n8n-connector over te nemen, gebruikt de Make-app de ingebouwde Iterator + Enrich Entity van Make. Elke iteratie is onafhankelijk, fouten cascaderen niet en de facturatie weerspiegelt precies wat er is verwerkt.

[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]

Belangrijkste functies

Meertalig in 40 talen

Eén enkele Enrich Entity-aanroep vult elke meertalige eigenschap in alle geselecteerde talen — geproduceerd in één LLM-doorloop, niet N opeenvolgende heen-en-weer-aanroepen. Wijs elke taal rechtstreeks toe: {{result.names.primary.fr}}.

Verrijking in één aanroep

Een speciaal POST /api/single/enrich/sync-endpoint verpakt de streamingflow aan de serverkant. Eén Make-bewerking = één bundel. Geen polling, geen patronen met twee modules.

Dynamische dropdowns (RPC's)

7 RPC's halen schema's, modellen, talen, strategieën, classificatie-/arbitragemodellen en webzoekopties op tijdens de configuratie — vastgezette schema's verschijnen eerst, modellabels bevatten prijzen.

Multi-model auto-fusie

Kies 2+ modellen en het resultaat wordt automatisch gefuseerd. De uitvoerbundel bevat is_fused, source_models[] en een fusion: {agreed_fields, conflicted_fields, total_fields}-samenvatting.

Pre-flightclassificatie

Een optioneel goedkoop classificatiemodel verifieert dat de entiteit overeenkomt met het verwachte type van het schema voordat de verrijking wordt uitgevoerd. Mismatches leveren een getypeerde DataError op in plaats van gehallucineerde gegevens.

Inzicht in planlimiet & credits

HTTP 402-fouten (planlimieten of onvoldoende credits) worden getypeerde Make OutOfMoneyError. Het bericht geeft het door mensen leesbare detail van de backend weer (met een URL om je saldo aan te vullen wanneer de credits op zijn) plus een machineleesbare code — vertak de foutafhandeling van het scenario op de code om mensen te waarschuwen, terug te vallen op goedkopere modellen of te pauzeren.

Vergrendelingen webzoek-dropdown

De dropdown Web Search leest parameters.models en schakelt zichzelf uit wanneer geen van de geselecteerde models supports_web_search declareert.

Geen batch-module

Make-scenario's rekenen per bewerking af. Workflows met meerdere entities gebruiken de ingebouwde Iterator + Enrich Entity van Make, wat granulaire foutafhandeling per entity en exacte facturatie oplevert.

Configureerbare time-out

Standaardtime-out van 300 seconden per aanroep, begrensd tot [10, 900]. De taak wordt serverzijde automatisch geannuleerd als deze niet op tijd klaar is, waarbij een getypeerde ConnectionError wordt geretourneerd.

Foutcontract

Elke status die de backend kan retourneren, wordt gekoppeld aan een getypeerde Make-fout, zodat scenario-foutafhandelaars kunnen vertakken op basis van de foutmodus in plaats van strings te parsen.

Make-scenario: foutafhandelaar die vertakt op OutOfMoneyError
HTTPMake-fouttypeWanneer het wordt geactiveerd
400DataErrorSchema niet gevonden, ontbrekende zoeksleutels, ongeldige modellen of talen.
401InvalidCredentialsOngeldige of ontbrekende API-sleutel.
402OutOfMoneyErrorPlanlimiet overschreden OF onvoldoende credits. Bericht = body.detail.detail (leesbaar, bevat een top-up-URL voor insufficient_credits) + body.detail.code (machineleesbaar). Vertak op de code: insufficient_credits, model_limit_exceeded, language_limit_exceeded, concurrent_job_limit_reached, daily/weekly/monthly_prompt_limit_exceeded.
403AccessDeniedErrorRol of scope onvoldoende.
404InvalidConfigurationErrorSchema of record niet gevonden.
422DataErrorClassificatiewaarschuwing. body.detail.classification bevat status, reasoning, confidence, entity_description.
429RateLimitErrorRate limit van provider (tijdelijk).
499RuntimeErrorJob geannuleerd.
502ConnectionErrorUpstream-LLM-providerfout (bijv. contextoverloop).
504ConnectionErrortimeout_seconds verstreken; taak automatisch geannuleerd aan de serverzijde.

Workflow-ideeën

CRM-verrijkingStart bij nieuwe HubSpot-/Salesforce-contacten, verrijk met bedrijfsgegevens en werk het CRM-record bij.
Spreadsheet-pipelineLees entiteiten uit Google Sheets, Iterator + Enrich Entity, en schrijf de resultaten terug naar een nieuw blad.
Voorwaardelijke her-arbitrageVoer eerst regelgebaseerde fusie uit; als conflicted_fields > 5, voer dan opnieuw een samenvoeging uit met een LLM-arbiter via Merge Results — zonder de kostbare verrijking opnieuw uit te voeren.
Routering op planlimietBij OutOfMoneyError: waarschuw een mens in Slack en pauzeer het scenario totdat het quotavenster wordt gereset.
Geplande vernieuwingVoer uit volgens een cron-schema (Make Schedule-trigger) om verouderde records opnieuw te verrijken met de nieuwste modellen.

Volgende stappen