n8n-connector - Entity Enricher-documentatie

n8n-connector

Met de Entity Enricher community-node voor n8n kun je geautomatiseerde verrijkingspijplijnen bouwen met een visuele drag-and-drop-editor. Verbind met 400+ apps zonder code te schrijven.

Installatie

Installeer de community node in je n8n-instantie:

npm install n8n-nodes-entity-enricher

Of installeer via de n8n-UI: ga naar Instellingen → Community Nodes en zoek naar n8n-nodes-entity-enricher.

Vereisten

API-sleutel— Maak een organization-toegangssleutel aan in Entity Enricher. Zie de documentatie over API-sleutels voor meer details. Het sleutelformaat is ent_XXXXXXXXXXXX.

Basis-URL— De URL van je Entity Enricher-instance (bijv. https://entityenricher.ai of je zelf-gehoste URL).

Credential instellen— Maak in n8n een Entity Enricher API-credential aan met je API-sleutel en base-URL. Alle nodes gebruiken deze credential. Een organisatietoegangssleutel werkt onafhankelijk van elk gebruikersaccount — de aanbeveling voor duurzame service-naar-service-workflows.

OAuth2 (alternatief)— Liever verbinden met je account? Maak in plaats daarvan een Entity Enricher OAuth2 API-credential aan: kopieer de OAuth-redirect-URL die n8n toont, registreer daarmee een OAuth-client in Entity Enricher onder API Keys → Verbonden apps → OAuth Clients (owner-rol), plak de client-ID in n8n en klik op Mijn account verbinden. De verbinding handelt met je eigen rol en is op elk moment intrekbaar onder Verbonden apps. Selecteer de credential op de node met de parameter Authenticatie.

Beschikbare bewerkingen

De connector biedt 18 bewerkingen in 7 resourcecategorieën:

Resource	Bewerking	Beschrijving
Enrichment	Enrich Entity	Verrijk één entity — kies gewoon een schema; het beste model en de beste strategie van je organization worden automatisch gekozen. Streamt resultaten via SSE met realtime voortgang.
Enrichment	Enrich Entity Advanced	Verrijk één entity met volledige controle over modellen, fusion, strategie, classificatie en gestructureerde output.
Enrichment	Batch Enrich	Verrijk alle invoeritems als één batch met het automatische model en de automatische strategie. Parallelle verwerking met voortgangsregistratie per entity.
Enrichment	Batch Enrich Advanced	Verrijk alle invoeritems als één batch met de volledige parameterset.
Schema	List Schemas	Toon beschikbare opgeslagen schema's ter selectie in enrichment-workflows.
Schema	Get Schema Details	Haal de volledige schema-inhoud op met geëxtraheerde belangrijkste eigenschappen voor een specifiek schema.
Schema	Generate Sample	Genereer in één job 1..N realistische JSON-voorbeeldobjecten van één entiteitstype — het startpunt van de lus voor het schrijven van schema's. Taal staat standaard op auto en wordt afgeleid uit de woorden van je eigen verzoek.
Schema	Generate Schema	Genereer en bewaar automatisch een JSON-schema — elk invoeritem is één sample van hetzelfde entiteitstype: de vereniging van alle velden, nullable waar een veld in sommige samples ontbreekt, echte waargenomen waarden als voorbeelden. Met de optie Taal bepaal je in welke taal het schema zichzelf beschrijft.
Record	List Records	Bevraag verrijkingsrecords met filters op type en succes. Gepagineerde resultaten.
Record	Get Record	Haal een specifiek enrichment-resultaat op via ID met volledige gestructureerde uitvoer.
Record	Sync Records to Database	Stuur een opgeslagen (of getransformeerde) verrijkingsoutput naar de Database Sync van het bijbehorende schema — opnieuw gevalideerd tegen het gepubliceerde contract en daarna door de toelatingspoort geleid.
Fusion	Merge Results	Fuseer resultaten van meerdere enrichment-records samen met optionele LLM-arbitrage.
Attachment	Add Attachment	Upload één of meer binaire bestanden van het invoeritem (één enkele multipart-request) en geef één item per bijlage-ID terug.
Attachment	Delete Attachment	Verwijder een bijlage op ID — een handige opschoonstap na de verrijking.
Database Sync	List Database Syncs	Toon de database syncs die op een schema geregistreerd zijn, met het aantal openstaande delta's.
Database Sync	Fetch Deltas	Haal het volgende FIFO-venster met database-delta's op (SQL + JSON), en lease ze optioneel voor bevestiging.
Database Sync	Acknowledge Deltas	Bevestig toegepaste delta's tot aan een ID — geeft de lease vrij en verwijdert, afhankelijk van de sync-opties, geleverde kopieën.
Configuration	Get Options	Haal beschikbare modellen, talen, strategieën en abonnementslimieten op voor dynamische configuratie.

Trigger-node

Het pakket bevat ook een aparte Entity Enricher Trigger-node — een webhook-trigger die een workflow start bij schema-gebeurtenissen en zijn abonnement automatisch registreert:

Verrijkingsresultaat— Wordt geactiveerd bij elke voltooide verrijking van het geselecteerde schema (met of zonder database sync).

Afgewezen voor database-opslag— Wordt geactiveerd wanneer een verrijking de toelatingspoort van een database sync niet passeert — de payload vertelt je welke verplichte velden ontbraken.

Database-delta's beschikbaar— Wordt geactiveerd zodra er nieuwe SQL-delta's klaarstaan voor een database sync. Met "Fetch Deltas on Fire" ingeschakeld haalt de node de openstaande delta's op en least ze, en geeft één item per delta door aan een volgende Acknowledge Deltas-stap. Een database die door meerdere schema's wordt gevoed, stuurt per schema een melding — elk schema stuurt zijn eigen workflow aan — dus kies naar welk gekoppeld schema deze trigger luistert.

Samen met de Database Sync-bewerkingen houdt de trigger een externe database geconvergeerd vanuit alleen n8n — zie de Database Sync-documentatie.

Enrichment van één entity

De eenvoudigste workflow: activeer bij nieuwe gegevens, verrijk één entiteit en stuur het resultaat naar je bestemming. De node wacht tot de volledige verrijking is voltooid voordat de gestructureerde output verder wordt doorgegeven.

Voorbeeldworkflow — verrijking van één entiteit:

Node-configuratie — bewerking Enrich Entity:

Configuratie

De standaardbewerkingen Enrich Entity en Batch Enrich tonen alleen het essentiële: schema, bestand uploaden, talen en webzoekopdracht. Entity Enricher draait automatisch met het beste model van je organization — je vastgezette standaardmodel of het model met de hoogste benchmarkscore — en kiest de verrijkingsstrategie op basis van je schema. De bewerkingen Enrich Entity Advanced en Batch Enrich Advanced tonen de volledige set opties hieronder.

Selecteer een schema uit het dynamische dropdownmenu, kies een of meer modellen en geef entiteitsgegevens op als sleutel-waardevelden. De node vult automatisch de zoeksleutelvelden in op basis van het geselecteerde schema.

Optionele instellingen omvatten strategie (single-pass of multi-expertise), talen voor meertalige uitvoer, classificatiemodel voor verificatie van het entiteitstype, arbitragemodel voor conflictoplossing tussen meerdere modellen, en response-schema / strikte gestructureerde uitvoer-schakelaars die schemaconforme uitvoer afdwingen op geschikte modellen.

Om brondocumenten in de enrichment te voeden, schakel je Upload Input Binary Files in: de node uploadt de binaire bestanden van het input-item als attachments in één enkele request (allemaal, of alleen die genoemd in Binary Fields to Upload) en ruimt ze, met Delete Uploaded Attachments After Enrichment (standaard aan), op zodra de enrichment klaar is — geen aparte Add Attachment / Delete Attachment stappen nodig. Je kunt ook een Attachment IDs-veld opgeven (door komma's gescheiden UUID's van eerdere Add Attachment-aanroepen) om eenmaal geüploade documenten in veel enrichments te hergebruiken; beide bronnen kunnen worden gecombineerd. Ook beschikbaar op Batch Enrich, waar bestanden uit alle input-items worden verzameld en op elke entity in de job worden toegepast. Als er een Edit Fields-node tussen de bestandsbron en de enrich-node staat, zet dan de schakelaar Include Other Input Fields aan — anders verwijdert die de binaire data.

Batchverrijking

Verwerk alle invoeritems als één batch. Ideaal voor het verrijken van lijsten uit spreadsheets, databases of API-antwoorden. Alle entiteiten worden parallel verwerkt met snelheidslimieten per provider.

Node-configuratie — bewerking Batch Enrich:

Configuratie van de Entity Enricher-node voor batchverrijking

Hoe de batchmodus werkt

Items verzamelen — De node verzamelt alle invoeritems van de vorige node (bijv. rijen uit een spreadsheet).
Batchtaak starten — Alle entiteiten worden ingediend via POST /api/batch/start en parallel verwerkt.
Voortgang streamen — De node verwerkt de SSE-stream totdat alle entiteiten klaar zijn of de time-out wordt bereikt.
Resultaten uitvoeren — Eén output-item per entiteit met de verrijkte gestructureerde data, klaar voor verdere verwerking.

Belangrijkste functies

Eenvoudige en geavanceerde bewerkingen

De standaardbewerkingen Enrich Entity en Batch Enrich tonen alleen schema, bestand uploaden, talen en webzoekopdracht — het beste model en de beste strategie worden automatisch gekozen. Met de geavanceerde bewerkingen krijg je volledige controle over modellen, fusion, strategie en gestructureerde output.

Dynamische dropdowns

De schema-, model-, taal- en strategiekiezers halen opties op uit je Entity Enricher-instantie tijdens het configureren.

SSE-streaming

Verrijkingsbewerkingen verbruiken de SSE-stream in realtime en wachten op voltooiing voordat ze resultaten aan de volgende node doorgeven.

Automatisch doorgaan

Wanneer de pre-flight-classificatie een mismatch detecteert, gaat de connector automatisch verder (n8n-workflows zijn niet-interactief).

Configureerbare time-out

Standaardtime-out van 300 seconden per enrichment-aanroep, per node aanpasbaar voor grote schema's of trage modellen.

Ondersteuning voor meerdere modellen

Selecteer meerdere modellen per enrichment. Wanneer 2+ modellen worden gebruikt, worden de resultaten automatisch samengevoegd.

Uitvoer standaard opschonen

Standaard bevat de uitvoer alleen de verrijkte gegevensvelden. Schakel "Verrijkingsmetadata opnemen" in om kosten, tokens, fusiedetails en record-ID's toe te voegen.

Uitvoer per model

Geef optioneel individuele modelresultaten naast het gefuseerde resultaat weer voor vergelijking verderop in het proces.

Inzicht in planlimieten

Dropdowns voor model en taal tonen de planlimieten wanneer deze zijn ingesteld. HTTP 402-fouten door quotahandhaving worden weergegeven als duidelijke, bruikbare berichten met limietdetails. De metadata-output bevat de huidige planlimieten voor downstream-routing.

Gebruik het vanuit een AI-agent, of begin met een voorbeeld

Een AI Agent-tool

De Entity Enricher-node kan als tool worden gekoppeld aan een n8n AI Agent, zodat een agent zelf bepaalt wanneer die midden in een gesprek een entity verrijkt of een schema ophaalt. De trigger-node wordt bewust niet zo aangeboden — een trigger start een workflow, het is niets dat een agent aanroept.

Zes importeerbare workflows

Het pakket bevat kant-en-klare workflowbestanden — enkele enrichment, batch, document naar enrichment, afbeelding naar sample naar schema, samples naar schema, en het leegtrekken van een deltafeed naar PostgreSQL. Importeer er een en zet je eigen credential erin in plaats van alles zelf op te bouwen.

Workflow-ideeën

Veelvoorkomende patronen voor het bouwen van enrichment-pijplijnen met n8n:

CRM-verrijking— Start bij nieuwe HubSpot-/Salesforce-contacten, verrijk met bedrijfsgegevens en werk het CRM-record bij.

Spreadsheet-pipeline— Lees entiteiten uit Google Sheets, verrijk in batch en schrijf de resultaten terug naar een nieuw blad.

Waterfall-enrichment— Koppel meerdere verrijkingsstappen aan elkaar met voorwaardelijke logica — gebruik eerst een snel model en verrijk mislukkingen opnieuw met een capabeler model.

Geplande vernieuwing— Voer uit volgens een cron-schema om verouderde records opnieuw te verrijken met de nieuwste AI-modellen.

Webhook-gestuurd— Stel een webhook-endpoint beschikbaar dat entiteitsgegevens accepteert, deze verrijkt en het resultaat synchroon retourneert.