Connecteur Make.com - Documentation Entity Enricher

Connecteur Make.com

Déposez un seul module Make dans n'importe quel scénario, mappez une entité depuis une étape précédente et recevez un objet JSON structuré, validé par schéma et issu d'une fusion multi-modèles — avec une sortie multilingue en 40 langues produite en une seule passe LLM. 9 modules de premier ordre avec listes déroulantes dynamiques et gestion des erreurs tenant compte des limites du plan, conçus pour le modèle de facturation par 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'application Make se trouve dans le dépôt public TOT-Concept (synchronisé depuis le monorepo Entity Enricher). En attendant que la v1.0 arrive 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 par clé API à l'aide d'une clé provenant d'Entity Enricher → Paramètres → Clés API (format ent_XXXXXXXXXXXX). La connexion se teste automatiquement sur /api/enrichment/options.
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.0Disponible dans la v0.4 avec l'authentification par clé API, dès que le serveur d'autorisation d'Entity Enricher sera prêt. Les scénarios des utilisateurs finaux pourront connecter leurs propres comptes via le flux OAuth standard de Make.

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é

Modules disponibles

9 modules répartis en 5 catégories. Les modules de recherche émettent un bundle par résultat pour les chaînes Iterator/Aggregator en aval ; les modules d'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.
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.
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.
ConfigurationGet OptionsModèles, langues, stratégies disponibles et limites du forfait de l'organisation.

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.

Listes déroulantes dynamiques (RPC)

7 RPC récupèrent les schémas, modèles, langues, stratégies, modèles de classification/arbitrage et options de recherche web au moment de la configuration — les schémas épinglés apparaissent en premier, les libellés des modèles incluent 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}.

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.

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