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.

Opérations disponibles

Le connecteur expose 10 opérations réparties en 6 catégories de ressources :

Ressource	Opération	Description
Enrichment	Enrich Entity	Enrichissez une seule entité avec un ou plusieurs modèles d'IA. Diffuse les résultats via SSE avec progression en temps réel.
Enrichment	Batch Enrich	Enrichissez tous les éléments d'entrée en un seul traitement par lot. Traitement parallèle avec suivi de progression par entité.
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.
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.
Fusion	Merge Results	Fusionnez les résultats de plusieurs enregistrements d'enrichissement avec arbitrage LLM optionnel.
Attachment	Add Attachment	Téléverser une propriété binaire depuis l'élément d'entrée (multipart) et renvoyer son ID de pièce jointe.
Attachment	Delete Attachment	Supprimez une pièce jointe par son ID — une étape de nettoyage post-enrichissement bien pratique.
Configuration	Get Options	Récupérez les modèles, langues, stratégies et limites de forfait disponibles pour une configuration dynamique.

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

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.

Fournissez un champ IDs de pièces jointes (UUID séparés par des virgules issus d'appels Add Attachment précédents) pour injecter des documents sources dans l'enrichissement — également disponible sur Batch Enrich.

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

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.

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.