Connecteur n8n - Documentation Entity Enricher

Connecteur n8n

Le nœud communautaire Entity Enricher pour n8n vous permet de créer des pipelines d'enrichissement automatisés avec un éditeur visuel par glisser-déposer. Connectez-vous à plus de 400 applications sans écrire de code.

Installation

Installez le nœud communautaire dans votre instance n8n :

npm install n8n-nodes-entity-enricher

Ou installez via l'interface n8n : allez dans Settings → Community Nodes et recherchez n8n-nodes-entity-enricher.

Prérequis

Clé API— Créez une clé d'accès d'organisation dans Entity Enricher. Consultez la documentation des clés API pour plus de détails. Le format de la clé est ent_XXXXXXXXXXXX.

URL de base— L'URL de votre instance Entity Enricher (par ex. https://entityenricher.ai ou votre URL auto-hébergée).

Configuration des identifiants— Dans n8n, créez un identifiant Entity Enricher API avec votre clé API et votre URL de base. Tous les nœuds utiliseront cet identifiant. Une clé d'accès d'organisation fonctionne indépendamment de tout compte utilisateur — la recommandation pour les workflows service-à-service durables.

OAuth2 (alternative)— Vous préférez vous connecter avec votre compte ? Créez plutôt un identifiant Entity Enricher OAuth2 API : copiez l'URL de redirection OAuth affichée par n8n, enregistrez un client OAuth avec celle-ci dans Entity Enricher sous API Keys → Connected Apps → OAuth Clients (rôle propriétaire), collez l'ID client dans n8n, puis cliquez sur Connect my account. La connexion agit avec votre propre rôle et est révocable à tout moment sous Connected Apps. Sélectionnez l'identifiant sur le nœud à l'aide de son paramètre Authentication.

Opérations disponibles

Le connecteur expose 18 opérations réparties sur 7 catégories de ressources :

Ressource	Opération	Description
Enrichment	Enrich Entity	Enrichissez une seule entité — il vous suffit de choisir un schéma ; le meilleur modèle et la meilleure stratégie de votre organisation sont sélectionnés automatiquement. Diffuse les résultats via SSE avec une progression en temps réel.
Enrichment	Enrich Entity Advanced	Enrichissez une seule entité avec un contrôle total sur les modèles, la fusion, la stratégie, la classification et la sortie structurée.
Enrichment	Batch Enrich	Enrichissez tous les éléments d'entrée en un seul traitement par lot avec le modèle et la stratégie automatiques. Traitement parallèle avec suivi de la progression par entité.
Enrichment	Batch Enrich Advanced	Enrichissez tous les éléments d'entrée en un seul traitement par lot avec l'ensemble complet des paramètres.
Schema	List Schemas	Liste les schémas enregistrés disponibles pour sélection dans les flux d'enrichissement.
Schema	Get Schema Details	Récupérez le contenu complet d'un schéma spécifique avec ses propriétés clés extraites.
Schema	Generate Sample	Générez 1..N objets JSON d'exemple réalistes d'un même type d'entité en une seule tâche — le point d'entrée de la boucle de rédaction de schéma. La langue est sur auto par défaut, déduite des mots de votre propre demande.
Schema	Generate Schema	Générez et enregistrez automatiquement un schéma JSON — chaque élément d'entrée est un échantillon du même type d'entité : union des champs, nullable là où un champ manque dans certains échantillons, valeurs réelles observées en exemples. Une option Langue définit la langue dans laquelle le schéma se décrit.
Record	List Records	Interrogez les enregistrements d'enrichissement avec des filtres par type et par réussite. Résultats paginés.
Record	Get Record	Récupérez un résultat d'enrichissement spécifique par son ID avec la sortie structurée complète.
Record	Sync Records to Database	Envoyez une sortie d'enrichissement stockée (ou transformée) vers la database sync de son schéma — revalidée par rapport au contrat publié, puis soumise au contrôle d'admission.
Fusion	Merge Results	Fusionnez les résultats de plusieurs enregistrements d'enrichissement avec arbitrage LLM optionnel.
Attachment	Add Attachment	Téléverse un ou plusieurs fichiers binaires de l'élément d'entrée (requête multipart unique) et renvoie un élément par ID de pièce jointe.
Attachment	Delete Attachment	Supprimez une pièce jointe par son ID — une étape de nettoyage post-enrichissement bien pratique.
Database Sync	List Database Syncs	Répertorie les synchronisations de base de données enregistrées sur un schéma, avec le nombre de deltas en attente.
Database Sync	Fetch Deltas	Récupère la prochaine fenêtre FIFO de deltas de base de données (SQL + JSON), en les plaçant éventuellement sous bail pour accusé de réception.
Database Sync	Acknowledge Deltas	Accuse réception des deltas appliqués jusqu'à un ID — libère le bail et, selon les options de synchronisation, purge les copies livrées.
Configuration	Get Options	Récupérez les modèles, langues, stratégies et limites de forfait disponibles pour une configuration dynamique.

Nœud déclencheur

Le package fournit également un nœud Entity Enricher Trigger distinct — un déclencheur webhook qui démarre un workflow lors d'événements de schéma, en enregistrant automatiquement son abonnement :

Résultat d'enrichissement— Se déclenche à chaque enrichissement terminé du schéma sélectionné (avec ou sans synchronisation de base de données).

Rejeté pour l'enregistrement en base de données— Se déclenche lorsqu'un enrichissement échoue au contrôle d'admission d'une synchronisation de base de données — le payload indique quels champs requis manquaient.

Deltas de base de données disponibles— Se déclenche lorsque de nouveaux deltas SQL sont prêts pour une Database Sync. Avec « Fetch Deltas on Fire » activé, le nœud récupère et réserve les deltas en attente, en émettant un élément par delta pour une étape Acknowledge Deltas en aval. Une base de données alimentée par plusieurs schémas notifie par schéma — chacun pilote son propre workflow — choisissez donc le schéma lié que ce déclencheur écoute.

Associé aux opérations Database Sync, le déclencheur maintient une base de données externe convergée depuis n8n seul — consultez la documentation Database Sync.

Enrichissement d'une entité unique

Le flux de travail le plus simple : déclenchement à l'arrivée de nouvelles données, enrichissement d'une seule entité et envoi du résultat vers votre destination. Le nœud attend la fin complète de l'enrichissement avant de transmettre la sortie structurée en aval.

Exemple de workflow — enrichissement d'une seule entité :

Configuration du nœud — opération Enrich Entity :

Configuration

Les opérations par défaut Enrichir l'entité et Enrichissement par lot n'affichent que l'essentiel : schéma, téléversement de fichier, langues et recherche web. Entity Enricher s'exécute automatiquement avec le meilleur modèle de votre organisation — votre modèle par défaut épinglé, ou le modèle le mieux noté au benchmark — et choisit la stratégie d'enrichissement à partir de votre schéma. Les opérations Enrichir l'entité (avancé) et Enrichissement par lot (avancé) exposent l'ensemble complet des options ci-dessous.

Sélectionnez un schéma dans la liste déroulante dynamique, choisissez un ou plusieurs modèles, puis fournissez les données d'entité sous forme de champs clé-valeur. Le nœud préremplit automatiquement les champs de clés de recherche en fonction du schéma sélectionné.

Les paramètres facultatifs incluent la stratégie (passe unique ou multi-expertise), les langues pour une sortie multilingue, le modèle de classification pour la vérification du type d'entité, le modèle d'arbitrage pour la résolution des conflits multi-modèles, ainsi que les options schéma de réponse / sortie structurée stricte qui imposent une sortie conforme au schéma sur les modèles compatibles.

Pour alimenter l'enrichissement en documents sources, activez Upload Input Binary Files : le nœud téléverse les fichiers binaires de l'élément d'entrée sous forme de pièces jointes en une seule requête (tous, ou seulement ceux nommés dans Binary Fields to Upload) et, avec Delete Uploaded Attachments After Enrichment (activé par défaut), les nettoie une fois l'enrichissement terminé — aucune étape distincte Add Attachment / Delete Attachment n'est nécessaire. Vous pouvez aussi fournir un champ Attachment IDs (UUID séparés par des virgules issus d'appels Add Attachment précédents) pour réutiliser des documents téléversés une seule fois dans de nombreux enrichissements ; les deux sources peuvent être combinées. Également disponible sur Batch Enrich, où les fichiers sont rassemblés à partir de tous les éléments d'entrée et s'appliquent à chaque entité du job. Si un nœud Edit Fields se trouve entre la source des fichiers et le nœud d'enrichissement, activez son commutateur Include Other Input Fields — sinon il supprime les données binaires.

Enrichissement par lot

Traitez tous les éléments d'entrée en un seul traitement par lot. Idéal pour enrichir des listes issues de feuilles de calcul, de bases de données ou de réponses API. Toutes les entités sont traitées en parallèle avec une limitation de débit par fournisseur.

Configuration du nœud — opération Batch Enrich :

Configuration du nœud Entity Enricher pour l'enrichissement par traitement par lot

Fonctionnement du mode traitement par lot

Collecte des éléments — Le nœud rassemble tous les éléments d'entrée du nœud précédent (p. ex. les lignes d'une feuille de calcul).
Démarrer le traitement par lot — Toutes les entités sont soumises via POST /api/batch/start et traitées en parallèle.
Suivi de la progression — Le nœud consomme le flux SSE jusqu'à ce que toutes les entités soient terminées ou que le délai d'attente soit atteint.
Résultats en sortie — Un élément de sortie par entité avec les données structurées enrichies, prêtes pour le traitement en aval.

Fonctionnalités clés

Opérations simples et avancées

Les opérations par défaut Enrichir l'entité et Enrichissement par lot n'affichent que le schéma, le téléversement de fichier, les langues et la recherche web — le meilleur modèle et la meilleure stratégie sont sélectionnés automatiquement. Les opérations avancées offrent un contrôle total sur les modèles, la fusion, la stratégie et la sortie structurée.

Listes déroulantes dynamiques

Les sélecteurs de schéma, de modèle, de langue et de stratégie récupèrent leurs options depuis votre instance Entity Enricher au moment de la configuration.

Streaming SSE

Les opérations d'enrichissement consomment le flux SSE en temps réel, en attendant la fin du traitement avant de renvoyer les résultats au nœud suivant.

Continuation automatique

Lorsque la classification préalable détecte une incohérence, le connecteur continue automatiquement (les workflows n8n sont non interactifs).

Délai d'expiration configurable

Délai d'expiration par défaut de 300 secondes par appel d'enrichissement, ajustable par nœud pour les grands schémas ou les modèles lents.

Prise en charge multi-modèles

Sélectionnez plusieurs modèles par enrichissement. Lorsque 2 modèles ou plus sont utilisés, les résultats sont automatiquement fusionnés.

Nettoyer la sortie par défaut

Par défaut, la sortie contient uniquement les champs de données enrichis. Activez « Inclure les métadonnées d'enrichissement » pour ajouter le coût, les tokens, les détails de fusion et les identifiants d'enregistrement.

Sortie par modèle

Produisez éventuellement les résultats individuels de chaque modèle aux côtés du résultat fusionné pour une comparaison en aval.

Prise en compte des limites du forfait

Les listes déroulantes de modèle et de langue affichent les limites du plan lorsqu'elles sont configurées. Les erreurs HTTP 402 liées à l'application des quotas sont présentées sous forme de messages clairs et exploitables, avec le détail des limites. Les métadonnées de sortie incluent les limites actuelles du plan pour le routage en aval.

Utilisez-le depuis un agent IA, ou partez d'un exemple

Un outil pour agent IA

Le nœud Entity Enricher peut être rattaché comme outil à un AI Agent n8n : l'agent décide alors lui-même quand enrichir une entité ou récupérer un schéma en pleine conversation. Le nœud déclencheur n'est délibérément pas proposé ainsi — un déclencheur démarre un workflow, ce n'est pas quelque chose qu'un agent appelle.

Six workflows importables

Le package fournit des fichiers de workflow prêts à l'emploi — enrichissement unique, traitement par lot, document vers enrichissement, image vers échantillon vers schéma, échantillons vers schéma, et vidage d'un flux de deltas vers PostgreSQL. Importez-en un et remplacez l'identifiant par le vôtre plutôt que de tout câbler de zéro.

Idées de workflow

Approches courantes pour construire des pipelines d'enrichissement avec n8n :

Enrichissement CRM— Se déclenche sur les nouveaux contacts HubSpot/Salesforce, enrichit avec les données de l'entreprise, met à jour l'enregistrement CRM.

Pipeline de feuilles de calcul— Lire les entités depuis Google Sheets, enrichir en traitement par lot, écrire les résultats dans une nouvelle feuille.

Enrichissement en cascade— Enchaînez plusieurs étapes d'enrichissement avec une logique conditionnelle — utilisez d'abord un modèle rapide, puis ré-enrichissez les échecs avec un modèle plus performant.

Actualisation planifiée— Exécutez selon une planification cron pour ré-enrichir les enregistrements obsolètes avec les derniers modèles d'IA.

Piloté par webhook— Exposez un point de terminaison webhook qui accepte des données d'entité, les enrichit et renvoie le résultat de manière synchrone.