Connecteur Make.com - Documentation Entity Enricher

Connecteur Make.com

Ajoutez un seul module Make dans n'importe quel scénario, mappez une entité issue d'une étape précédente et recevez un objet JSON structuré, validé par schéma et fusionné entre plusieurs modèles — avec une sortie multilingue en 40 langues produite en une seule passe LLM. 15 modules de premier plan, avec listes déroulantes dynamiques et gestion des erreurs tenant compte des limites de l'offre, conçus pour le modèle de facturation à l'opération de Make.

Conçu pour Make

Entity Enricher propose déjà un connecteur n8n qui consomme un flux Server-Sent Events. Les modules Make ne peuvent pas consommer nativement le SSE — chaque module correspond à un appel HTTP atomique. Pour prendre en charge l'enrichissement en une seule opération Make, le backend expose un point de terminaison dédié POST /api/single/enrich/sync qui encapsule le flux de streaming côté serveur et renvoie le résultat final fusionné en une seule réponse.

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]

Enrichissement multilingue en une seule passe

Sélectionnez plusieurs langues dans le champ Langues et Entity Enricher renseigne chaque propriété multilingue dans toutes les langues sélectionnées en un seul appel LLM — sans N allers-retours séquentiels par langue. 40 langues couvrent les principaux marchés européens, asiatiques, moyen-orientaux et africains.

Résultat d'un appel Enrich Entity avec 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": "痛み、発熱、炎症;抗血小板療法。"
  }
}

Les modules Make en aval peuvent mapper n'importe quelle langue directement : {{enrichEntity.result.names.primary.fr}}. La liste déroulante Langues affiche la liste complète des 40 langues, avec un avertissement de limite de forfait lorsque le profil de votre organisation restreint le nombre de langues sélectionnables.

Module Make : liste déroulante multi-sélection des langues affichant les 40 langues prises en charge

Installation

Le code source de l'app Make se trouve dans le dépôt public TOT-Concept (synchronisé depuis le monorepo Entity Enricher). En attendant sa publication sur la marketplace Make, installez-la manuellement via le Developer Hub :

  1. Connectez-vous à votre organisation Make en tant que développeur.
  2. Accédez à Apps → Créer une nouvelle app → App personnalisée.
  3. Téléversez le répertoire make-app-entity-enricher/ sous forme de .zip, ou collez chaque fichier .json / .imljson dans son onglet de l'éditeur.
  4. Ajoutez une connexion — soit une connexion par clé API à l'aide d'une clé provenant de Entity Enricher → Paramètres → API Keys (format ent_XXXXXXXXXXXX, testée automatiquement sur /api/enrichment/options), soit une connexion OAuth 2.0 : connectez-vous à Entity Enricher et cliquez sur Authorize.
Make : formulaire de configuration de la connexion par clé API

Listes déroulantes dynamiques

Chaque champ sélectionnable dans les modules Make est alimenté par un RPC qui interroge l'API Entity Enricher au moment de la configuration. Les schémas épinglés apparaissent en premier (marqués d'un 📌), les libellés des modèles incluent le tarif par million de tokens, et les organisations à plan limité voient un avertissement lorsque leur quota est atteint.

Module Make : liste déroulante des schémas ouverte avec les schémas épinglés en haut

Prérequis

Clé APICréez une clé d'accès d'organisation dans Entity Enricher. Consultez la documentation des clés API. Utilisez une clé d'accès d'organisation (avec son propre rôle) pour les intégrations de service à service.
URL de baseL'URL de votre instance Entity Enricher — par défaut https://entityenricher.ai. Ne la modifiez que pour les déploiements auto-hébergés.
OAuth 2.0 (alternative)Au lieu d'une clé API, choisissez le type de connexion Entity Enricher OAuth 2.0 : connectez-vous à Entity Enricher et cliquez sur Authorize — aucune clé à copier. La connexion agit en votre nom avec votre propre rôle et peut être révoquée à tout moment sous API Keys → Connected Apps. Les clés API restent la recommandation pour les scénarios service-à-service durables.

L'enrichissement d'entité en action

Le module central expose ses champs d'entrée avec des listes déroulantes dynamiques : schéma, modèles (sélection multiple), langues (sélection multiple), stratégie, modèles de classification et d'arbitrage optionnels, recherche web, schéma de réponse, sortie structurée stricte, délai d'expiration et options de métadonnées. Mappez une entité depuis n'importe quel module précédent via le champ Entity data.

Lorsque 2 modèles ou plus sont sélectionnés, le résultat est automatiquement fusionné côté serveur. Le panneau de sortie Make affiche is_fused: true, la liste des source_models et un résumé de fusion comptant les champs concordants et en conflit :

Panneau de sortie Make : résultat d'enrichissement multi-modèle fusionné
Ce que le paquet de sortie contient d'autre
  • identity_merges — chaque fois que cette exécution a réutilisé une identité existante créée à partir de termes différents, avec la similarité qui a tranché (vide lorsqu'une correspondance exacte de code ou de token a décidé, aucune similarité n'ayant alors été mesurée).
  • entity_keys — les valeurs de colonnes clés réellement enregistrées, afin qu'un module en aval puisse cibler la ligne qu'il vient de créer sans avoir à deviner.
  • Un statut d'écriture en base qui signale honnêtement une écriture partielle au lieu de la présenter comme une simple réussite, aux côtés de skipped_items et key_collisions.
  • Sur les enregistrements : retries, qui remplace l'ancien champ attempts — un renommage cassant, pensez donc à mettre à jour tout scénario qui le mappait.

Modules disponibles

15 modules répartis en 7 catégories. Les modules Search émettent un bundle par résultat pour les chaînes Iterator/Aggregator en aval ; les modules Action émettent un seul bundle.

CatégorieModuleDescription
EnrichmentEnrich EntityEnrichissement en un seul appel avec fusion multi-modèles. Renvoie le résultat final fusionné (ou celui du meilleur modèle unique). S'annule automatiquement en cas d'avertissement de classification.
SchemasList SchemasRenvoie un bundle Make par schéma enregistré, prêt pour les chaînes Iterator/Aggregator.
SchemasGet Schema DetailsContenu complet du schéma, y compris les domaines d'expertise, les propriétés et les clés de recherche.
SchemasGenerate SampleGénérez 1..N objets JSON d'exemple réalistes d'un même type d'entité en un seul appel bloquant — le point d'entrée de la création de schéma. Le premier exemple définit l'ensemble des champs ; les autres sont des variantes d'instance partageant les mêmes champs.
SchemasGenerate SchemaGénérez et enregistrez automatiquement un schéma JSON à partir de 1..N objets d'exemple d'un même type d'entité — union des champs, nullable là où un champ manque dans certains exemples, valeurs réelles observées comme exemples.
RecordsList RecordsRecherchez dans les enregistrements d'enrichissement passés à l'aide de filtres (type, succès, texte libre).
RecordsGet RecordRécupérez un résultat d'enrichissement unique avec les métriques complètes par prompt.
RecordsInject Records into DatabaseEnvoyez une sortie d'enrichissement stockée (ou transformée) vers la database sync de son schéma. Revalidée par rapport au contrat publié du schéma, puis soumise au contrôle d'admission.
FusionMerge ResultsRefusionner plusieurs résultats d'enrichissement, éventuellement avec un autre arbitre LLM.
AttachmentsUpload AttachmentTéléverser un fichier (mappé comme buffer depuis un module en amont, p. ex. HTTP ▸ Get a File) et renvoyer son ID de pièce jointe pour utilisation dans Enrich Entity.
AttachmentsDelete AttachmentSupprimez une pièce jointe par son ID — une étape de nettoyage post-enrichissement bien pratique.
Database SyncList Database SyncsRenvoie les synchronisations de base de données d'un schéma, avec le nombre de deltas en attente.
Database SyncFetch Database DeltasRenvoie la prochaine fenêtre FIFO de deltas SQL pour une synchronisation de base de données. Lorsque Claim est activé, les lignes sont placées sous bail et doivent faire l'objet d'un accusé de réception ; sinon, la lecture est rejouable.
Database SyncAcknowledge Database DeltasAccuse réception des deltas appliqués jusqu'à un ID — libère le bail et, selon les options de synchronisation, purge les copies livrées.
ConfigurationGet OptionsModèles, langues, stratégies disponibles et limites du forfait de l'organisation.

Les modules Database Sync alimentent le flux de deltas de synchronisation de base de données depuis un scénario planifié : Fetch Database Deltas réserve la fenêtre SQL suivante, un module de base de données ou HTTP l'applique, et Acknowledge Database Deltas la confirme (mappez le Next Cursor de Fetch vers Acknowledge).

Workflows multi-entités : pattern itérateur

Les scénarios Make facturent par opération. Au lieu de porter le module Batch Enrich du connecteur n8n, l'application Make utilise l'Iterator intégré de Make + Enrich Entity. Chaque itération est indépendante, les échecs ne se propagent pas et la facturation reflète exactement ce qui a été traité.

[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]

Fonctionnalités clés

Multilingue en 40 langues

Un seul appel Enrich Entity renseigne toutes les propriétés multilingues dans toutes les langues sélectionnées — générées en une seule passe LLM, et non en N allers-retours séquentiels. Mappez n'importe quelle langue directement : {{result.names.primary.fr}}.

Enrichissement en un appel

Un endpoint dédié POST /api/single/enrich/sync encapsule le flux de streaming côté serveur. Une opération Make = un bundle. Pas de polling, pas de patterns à deux modules.

Simple par défaut

Le module Enrichir une entité s'ouvre avec uniquement les données d'entité, le schéma, les langues et la recherche web — Entity Enricher s'exécute automatiquement avec le meilleur modèle de votre organisation. Les modèles, les pièces jointes, la stratégie et les options de classification/arbitrage se trouvent derrière le bouton « Afficher les paramètres avancés » de Make.

Listes déroulantes dynamiques (RPC)

10 RPC récupèrent les schémas, les synchronisations de base de données, les modèles, les langues, les stratégies, les modèles de classification/arbitrage, ainsi que les options de schéma de réponse et de sortie structurée au moment de la configuration — les schémas épinglés apparaissent en premier, les libellés des modèles indiquent la tarification.

Fusion automatique multi-modèles

Choisissez 2 modèles ou plus et le résultat est automatiquement fusionné. Le bundle de sortie inclut is_fused, source_models[] et un résumé fusion : {agreed_fields, conflicted_fields, total_fields, method, arbitration_model}.

Classification préalable

Un modèle de classification économique facultatif vérifie que l'entité correspond au type attendu par le schéma avant l'exécution de l'enrichissement. Les non-correspondances produisent une DataError typée au lieu de données hallucinées.

Prise en compte des limites du forfait et des crédits

Les erreurs HTTP 402 (limites du plan ou crédits insuffisants) deviennent des erreurs typées Make OutOfMoneyError. Le message reprend le détail lisible du backend (avec une URL de rechargement de facturation lorsque les crédits sont épuisés) ainsi qu'un code lisible par machine — branchez le gestionnaire d'erreurs du scénario sur ce code pour alerter des humains, basculer vers des modèles moins chers ou mettre en pause.

Verrouillages de la liste déroulante de recherche web

Le menu déroulant Recherche Web lit parameters.models et se désactive lorsqu'aucun des modèles sélectionnés ne déclare supports_web_search.

Aucun module de traitement par lot

Les scénarios Make facturent par opération. Les workflows multi-entités utilisent l'Iterator intégré de Make + Enrich Entity, offrant une gestion des erreurs granulaire par entité et une facturation exacte.

Délai d'expiration configurable

Délai d'expiration par défaut de 300 secondes par appel, borné à [10, 900]. Le travail est automatiquement annulé côté serveur s'il ne se termine pas à temps, en renvoyant une ConnectionError typée.

Contrat d'erreur

Chaque statut que le backend peut renvoyer est associé à une erreur Make typée, afin que les gestionnaires d'erreurs de scénario puissent réagir selon le mode d'échec plutôt que d'analyser des chaînes de caractères.

Scénario Make : gestionnaire d'erreurs avec branchement sur OutOfMoneyError
HTTPType d'erreur MakeQuand il se déclenche
400DataErrorSchéma introuvable, clés de recherche manquantes, modèles ou langues invalides.
401InvalidCredentialsClé API invalide ou manquante.
402OutOfMoneyErrorLimite du forfait dépassée OU crédits insuffisants. Message = body.detail.detail (lisible par un humain, inclut une URL de rechargement pour insufficient_credits) + body.detail.code (lisible par machine). Branchez selon le code : insufficient_credits, model_limit_exceeded, language_limit_exceeded, concurrent_job_limit_reached, daily/weekly/monthly_prompt_limit_exceeded.
403AccessDeniedErrorRôle ou portée insuffisants.
404InvalidConfigurationErrorSchéma ou enregistrement introuvable.
422DataErrorAvertissement de classification. body.detail.classification contient status, reasoning, confidence, entity_description.
429RateLimitErrorLimite de débit du fournisseur (transitoire).
499RuntimeErrorTâche annulée.
502ConnectionErrorErreur du fournisseur LLM en amont (p. ex. dépassement de contexte).
504ConnectionErrortimeout_seconds écoulé ; tâche annulée automatiquement côté serveur.

Partir d'un scénario d'exemple

L'application fournit six blueprints de scénario importables — enrichissement unique, le modèle de traitement par lot avec Iterator, document vers enrichissement, image vers échantillon vers schéma, échantillons vers schéma, et vidage du flux de deltas d'une synchronisation de base de données. Importez-en un et remplacez la connexion par la vôtre plutôt que de câbler les modules de zéro.

Idées de workflow

Enrichissement CRMSe 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 calculLire les entités depuis Google Sheets, Iterator + Enrich Entity, écrire les résultats dans une nouvelle feuille.
Ré-arbitrage conditionnelExécutez d'abord la fusion basée sur des règles ; si conflicted_fields > 5, refusionnez avec un arbitre LLM via Merge Results — sans relancer l'enrichissement coûteux.
Routage selon les limites du forfaitEn cas d'OutOfMoneyError, alertez un humain dans Slack et mettez le scénario en pause jusqu'à la réinitialisation de la fenêtre de quota.
Actualisation planifiéeExécutez selon une planification cron (déclencheur Make Schedule) pour ré-enrichir les enregistrements obsolètes avec les derniers modèles.

Prochaines étapes