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
ent_XXXXXXXXXXXX.https://entityenricher.ai of je zelf-gehoste URL).Beschikbare bewerkingen
De connector biedt 10 bewerkingen verdeeld over 6 resourcecategorieën:
| Resource | Bewerking | Beschrijving |
|---|---|---|
| Enrichment | Enrich Entity | Verrijk één entiteit met een of meer AI-modellen. Streamt resultaten via SSE met realtime voortgang. |
| Enrichment | Batch Enrich | Verrijk alle invoeritems als één batch. Parallelle verwerking met voortgangsregistratie per entiteit. |
| 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. |
| 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. |
| Fusion | Merge Results | Fuseer resultaten van meerdere enrichment-records samen met optionele LLM-arbitrage. |
| Attachment | Add Attachment | Upload een binaire eigenschap uit het invoeritem (multipart) en ontvang de bijbehorende attachment-ID. |
| Attachment | Delete Attachment | Verwijder een bijlage op ID — een handige opschoonstap na de verrijking. |
| Configuration | Get Options | Haal beschikbare modellen, talen, strategieën en abonnementslimieten op voor dynamische configuratie. |
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
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.
Geef een veld Attachment-ID's op (door komma's gescheiden UUID's uit eerdere Add Attachment-aanroepen) om bronnendocumenten aan de enrichment toe te voegen — ook beschikbaar bij Batch Enrich.
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:
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/starten 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
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.
Workflow-ideeën
Veelvoorkomende patronen voor het bouwen van enrichment-pijplijnen met n8n: