Make.com-connector - Entity Enricher-documentatie

Make.com-connector

Zet één Make-module in een willekeurig scenario, koppel een entiteit uit een vorige stap en ontvang een gestructureerd, schema-gevalideerd JSON-object dat door meerdere modellen is gefuseerd — met meertalige uitvoer in 40 talen, geproduceerd in één enkele LLM-pass. 15 volwaardige modules met dynamische dropdowns en foutafhandeling die rekening houdt met plangrenzen, ontworpen voor het facturatiemodel per operatie 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). Zolang de app nog niet in de Make-marketplace staat, kun je hem sideloaden 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 verbinding toe — ofwel een API Key-verbinding met een sleutel uit Entity Enricher → Instellingen → API Keys (formaat ent_XXXXXXXXXXXX, automatisch getest tegen /api/enrichment/options), of een OAuth 2.0-verbinding: meld je aan bij Entity Enricher en klik op Autoriseren.
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.0 (alternatief)Kies in plaats van een API-sleutel het verbindingstype Entity Enricher OAuth 2.0: meld je aan bij Entity Enricher en klik op Autoriseren — geen sleutel om te kopiëren. De verbinding handelt namens jou met je eigen rol en kan op elk moment worden ingetrokken onder API Keys → Verbonden apps. API-sleutels blijven de aanbeveling voor duurzame service-naar-service-scenario's.

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
Wat de uitvoerbundel verder bevat
  • identity_merges — elke keer dat deze run een bestaande identiteit hergebruikte die uit andere woorden was ontstaan, met de gelijkenis die de doorslag gaf (leeg wanneer een exacte code- of tokenmatch besliste, omdat er dan geen gelijkenis is gemeten).
  • entity_keys — de daadwerkelijk opgeslagen waarden van de sleutelkolommen, zodat een volgende module de zojuist aangemaakte rij kan aanspreken zonder te gokken.
  • Een status voor het schrijven naar de database die een gedeeltelijke schrijfactie eerlijk als zodanig meldt in plaats van als gewoon succes, naast skipped_items en key_collisions.
  • Op records: retries, dat het oudere veld attempts vervangt — een breaking hernoeming, dus pas elk scenario aan dat dit veld mapte.

Beschikbare modules

15 modules verdeeld over 7 categorieën. Search-modules geven één bundle per resultaat af voor Iterator-/Aggregator-ketens verderop; Action-modules geven één enkele bundle af.

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.
SchemasGenerate SampleGenereer 1..N realistische voorbeeld-JSON-objecten van één entiteitstype in één blokkerende aanroep — het startpunt van het opstellen van schema's. Het eerste voorbeeld bepaalt de veldenset; de rest zijn instantievarianten met dezelfde velden.
SchemasGenerate SchemaGenereer en sla automatisch een JSON-schema op uit 1..N voorbeeldobjecten van hetzelfde entiteitstype — vereniging van velden, nullable waar een veld in sommige voorbeelden ontbreekt, echte waargenomen waarden als voorbeelden.
RecordsList RecordsZoek eerdere verrijkingsrecords met filters (type, succes, vrije tekst).
RecordsGet RecordHaal één enkel enrichment-resultaat op met volledige metrics per prompt.
RecordsInject Records into DatabaseStuur een opgeslagen (of getransformeerde) verrijkingsoutput naar de Database Sync van het bijbehorende schema. Opnieuw gevalideerd tegen het gepubliceerde contract van het schema en daarna door de toelatingspoort geleid.
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.
Database SyncList Database SyncsGeeft de database syncs van een schema terug, met het aantal openstaande delta's.
Database SyncFetch Database DeltasGeeft het volgende FIFO-venster met SQL-delta's voor een database sync terug. Wanneer Claim is ingeschakeld, worden de rijen geleaset en moeten ze worden bevestigd; anders is de lezing herhaalbaar.
Database SyncAcknowledge Database DeltasBevestigt toegepaste delta's tot aan een ID — geeft de lease vrij en verwijdert, afhankelijk van de sync-opties, geleverde kopieën.
ConfigurationGet OptionsBeschikbare models, talen, strategieën en de plan-limieten van de organization.

De Database Sync-modules voeden de deltafeed van database sync vanuit een gepland scenario: Fetch Database Deltas leaset het volgende SQL-venster, een database- of HTTP-module past het toe, en Acknowledge Database Deltas bevestigt het (koppel de Next Cursor van Fetch aan Acknowledge).

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.

Standaard Eenvoudig

De module Entiteit verrijken opent met alleen entiteitgegevens, schema, talen en zoeken op het web — Entity Enricher draait automatisch met het beste model van je organisatie. Modellen, bijlagen, strategie en opties voor classificatie/arbitrage staan achter de schakelaar "Geavanceerde instellingen tonen" van Make.

Dynamische dropdowns (RPC's)

10 RPC's halen bij het configureren schema's, database syncs, modellen, talen, strategieën, classificatie-/arbitragemodellen en opties voor response-schema en gestructureerde uitvoer op — vastgezette schema's staan bovenaan, modellabels vermelden de prijs.

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, method, arbitration_model}-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.

Begin met een voorbeeldscenario

De app bevat zes importeerbare scenario-blueprints — enkele enrichment, het Iterator-batchpatroon, document naar enrichment, afbeelding naar sample naar schema, samples naar schema, en het leegtrekken van de deltafeed van een database sync. Importeer er een en zet je eigen connectie erin in plaats van de modules helemaal zelf op te bouwen.

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