Make.com-Connector – Entity Enricher Dokumentation

Make.com-Connector

Fügen Sie ein einzelnes Make-Modul in ein beliebiges Scenario ein, ordnen Sie eine Entity aus einem vorherigen Schritt zu und erhalten Sie ein strukturiertes, schemavalidiertes, aus mehreren Modellen fusioniertes JSON-Objekt — mit mehrsprachiger Ausgabe in 40 Sprachen, erzeugt in einem einzigen LLM-Durchlauf. 9 erstklassige Module mit dynamischen Dropdowns und planlimit-bewusster Fehlerbehandlung, konzipiert für Makes Abrechnungsmodell pro Operation.

Für Make konzipiert

Entity Enricher liefert bereits einen n8n-Connector, der einen Server-Sent-Events-Stream konsumiert. Make-Module können SSE nicht nativ konsumieren – jedes Modul ist ein atomarer HTTP-Aufruf. Um Anreicherung als einzelne Make-Operation zu unterstützen, stellt das Backend einen dedizierten POST /api/single/enrich/sync-Endpunkt bereit, der den Streaming-Ablauf serverseitig kapselt und das finale fusionierte Ergebnis in einer Antwort zurückgibt.

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]

Mehrsprachige Anreicherung in einem Durchlauf

Wählen Sie im Feld Sprachen mehr als eine Sprache aus, und Entity Enricher befüllt jede mehrsprachige Eigenschaft in allen ausgewählten Sprachen mit einem einzigen LLM-Aufruf – nicht in N aufeinanderfolgenden Durchläufen pro Sprache. 40 Sprachen decken die wichtigsten europäischen, asiatischen, nahöstlichen und afrikanischen Märkte ab.

Ergebnis eines einzelnen Enrich-Entity-Aufrufs mit 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": "痛み、発熱、炎症;抗血小板療法。"
  }
}

Nachgelagerte Make-Module können jede Sprache direkt zuordnen: {{enrichEntity.result.names.primary.fr}}. Das Sprachen-Dropdown zeigt die vollständige Liste mit 40 Sprachen an, mit einem Hinweis zur Plan-Grenze, wenn das Profil Ihrer Organisation die Anzahl der auswählbaren Sprachen begrenzt.

Make-Modul: Mehrfachauswahl-Dropdown „Sprachen“ mit 40 unterstützten Sprachen

Installation

Der Quellcode der Make-App befindet sich im öffentlichen TOT-Concept-Repository (synchronisiert aus dem Entity Enricher-Monorepo). Bis v1.0 im Make-Marketplace erscheint, laden Sie sie per Sideload über den Developer Hub:

  1. Melden Sie sich als Entwickler bei Ihrer Make-Organisation an.
  2. Gehen Sie zu Apps → Neue App erstellen → Custom App.
  3. Laden Sie entweder das Verzeichnis make-app-entity-enricher/ als .zip hoch oder fügen Sie jede .json-/.imljson-Datei in ihren Tab im Editor ein.
  4. Fügen Sie eine API-Key-Verbindung hinzu, mit einem Schlüssel aus Entity Enricher → Einstellungen → API-Schlüssel (Format ent_XXXXXXXXXXXX). Die Verbindung wird automatisch gegen /api/enrichment/options getestet.
Make: Einrichtungsformular für die API-Key-Verbindung

Dynamische Dropdowns

Jedes auswählbare Feld in den Make-Modulen wird durch einen RPC befüllt, der zur Konfigurationszeit die Entity Enricher API aufruft. Angeheftete Schemas erscheinen zuerst (mit 📌 markiert), Modell-Bezeichnungen enthalten die Preise pro Million Token, und Organisationen mit begrenztem Tarif sehen einen Hinweis, wenn ihr Kontingent erreicht ist.

Make-Modul: Geöffnetes Dropdown „Schemas“ mit angehefteten Schemas oben

Voraussetzungen

API-SchlüsselErstellen Sie einen Organisationszugriffsschlüssel in Entity Enricher. Siehe die API-Schlüssel-Dokumentation. Verwenden Sie einen Organisationszugriffsschlüssel (mit eigener Rolle) für Service-zu-Service-Integrationen.
Basis-URLDie URL Ihrer Entity Enricher-Instanz — standardmäßig https://entityenricher.ai. Überschreiben Sie diese nur bei selbst gehosteten Bereitstellungen.
OAuth 2.0Kommt in v0.4 zusammen mit der API-Schlüssel-Authentifizierung, sobald der Autorisierungsserver von Entity Enricher verfügbar ist. Endbenutzer-Szenarien können ihre eigenen Konten über den standardmäßigen Make-OAuth-Flow verbinden.

Entität anreichern in Aktion

Das zentrale Modul stellt seine Eingabefelder mit dynamischen Dropdowns bereit: Schema, Modelle (Mehrfachauswahl), Sprachen (Mehrfachauswahl), Strategie, optionale Klassifizierungs- und Arbitrierungsmodelle, Websuche, Antwortschema, striktes strukturiertes Output, Timeout und Metadaten-Umschalter. Ordnen Sie eine Entität aus einem beliebigen vorherigen Modul über das Feld Entitätsdaten zu.

Wenn 2 oder mehr Modelle ausgewählt sind, wird das Ergebnis automatisch serverseitig fusioniert. Das Make-Ausgabefeld zeigt is_fused: true, die Liste der source_models und eine fusion-Zusammenfassung, die übereinstimmende und widersprüchliche Felder zählt:

Make-Ausgabebereich: fusioniertes Anreicherungsergebnis aus mehreren Modellen

Verfügbare Module

9 Module in 5 Kategorien. Suchmodule erzeugen pro Ergebnis ein Bundle für nachgelagerte Iterator-/Aggregator-Ketten; Aktionsmodule erzeugen ein einzelnes Bundle.

KategorieModulBeschreibung
EnrichmentEnrich EntityAnreicherung mit einem einzigen Aufruf und Multi-Modell-Fusion. Gibt das endgültige fusionierte Ergebnis (oder das des besten Einzelmodells) zurück. Bricht bei einer Klassifizierungswarnung automatisch ab.
SchemasList SchemasGibt ein Make-Bundle pro gespeichertem Schema zurück, bereit für Iterator-/Aggregator-Ketten.
SchemasGet Schema DetailsVollständiger Schema-Inhalt einschließlich Expertise-Domänen, Eigenschaften und Suchschlüsseln.
RecordsList RecordsFrühere Anreicherungs-Datensätze mit Filtern durchsuchen (Typ, Erfolg, Freitext).
RecordsGet RecordEin einzelnes Enrichment-Ergebnis mit vollständigen Metriken pro Prompt abrufen.
FusionMerge ResultsMehrere Anreicherungsergebnisse erneut zusammenführen, optional mit einem anderen LLM-Arbiter.
AttachmentsUpload AttachmentLaden Sie eine Datei hoch (als Buffer aus einem vorgelagerten Modul zugeordnet, z. B. HTTP ▸ Get a File) und erhalten Sie deren Attachment-ID zur Verwendung in Enrich Entity.
AttachmentsDelete AttachmentEinen Anhang anhand der ID löschen – ein praktischer Aufräumschritt nach der Anreicherung.
ConfigurationGet OptionsVerfügbare Modelle, Sprachen, Strategien und die Tarifgrenzen der Organisation.

Multi-Entität-Workflows: Iterator-Muster

Make-Szenarien werden pro Operation abgerechnet. Anstatt das Batch-Enrich-Modul des n8n-Connectors zu portieren, verwendet die Make-App den integrierten Iterator + Enrich Entity von Make. Jede Iteration ist unabhängig, Fehler pflanzen sich nicht fort, und die Abrechnung spiegelt genau das wider, was verarbeitet wurde.

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

Wichtige Funktionen

Mehrsprachig in 40 Sprachen

Ein einzelner „Entität anreichern“-Aufruf befüllt jede mehrsprachige Eigenschaft in allen ausgewählten Sprachen – erzeugt in einem einzigen LLM-Durchlauf, nicht in N aufeinanderfolgenden Anfragen. Jede Sprache lässt sich direkt zuordnen: {{result.names.primary.fr}}.

Ein-Aufruf-Anreicherung

Ein dedizierter POST /api/single/enrich/sync-Endpunkt kapselt den Streaming-Ablauf serverseitig. Ein Make-Vorgang = ein Bundle. Kein Polling, keine Zwei-Modul-Muster.

Dynamische Dropdowns (RPCs)

7 RPCs laden zur Konfigurationszeit Schemas, Modelle, Sprachen, Strategien, Klassifizierungs-/Arbitrierungsmodelle und Websuche-Optionen – angeheftete Schemas erscheinen zuerst, Modellbezeichnungen enthalten Preisangaben.

Multi-Modell-Auto-Fusion

Wählen Sie 2+ Modelle, und das Ergebnis wird automatisch fusioniert. Das Ausgabepaket enthält is_fused, source_models[] und eine fusion: {agreed_fields, conflicted_fields, total_fields}-Zusammenfassung.

Pre-Flight-Klassifizierung

Ein optionales günstiges Classification-Modell überprüft, ob die Entity dem vom Schema erwarteten Typ entspricht, bevor die Enrichment ausgeführt wird. Nichtübereinstimmungen erzeugen einen typisierten DataError statt halluzinierter Daten.

Plan-Limit- & Credit-Berücksichtigung

HTTP-402-Fehler (Plan-Limits oder unzureichende Credits) werden zu typisierten Make-OutOfMoneyError. Die Nachricht gibt die menschenlesbare Detailangabe des Backends wieder (mit einer Auflade-URL für die Abrechnung, wenn die Credits aufgebraucht sind) sowie einen maschinenlesbaren Code – verzweigen Sie den Fehlerhandler des Szenarios anhand des Codes, um Menschen zu benachrichtigen, auf günstigere Modelle auszuweichen oder zu pausieren.

Websuche-Dropdown-Sperren

Das Web-Search-Dropdown liest parameters.models und deaktiviert sich selbst, wenn keines der ausgewählten Modelle supports_web_search deklariert.

Kein Batch-Modul

Make-Szenarien werden pro Operation abgerechnet. Workflows mit mehreren Entitäten nutzen den integrierten Iterator + Enrich Entity von Make und ermöglichen so eine granulare Fehlerbehandlung pro Entität sowie eine exakte Abrechnung.

Konfigurierbares Timeout

Standard-Timeout von 300 Sekunden pro Aufruf, begrenzt auf [10, 900]. Der Job wird serverseitig automatisch abgebrochen, wenn er nicht rechtzeitig abgeschlossen wird, und gibt einen typisierten ConnectionError zurück.

Fehlervertrag

Jeder Status, den das Backend zurückgeben kann, wird einem typisierten Make-Fehler zugeordnet, sodass Szenario-Fehlerbehandlungen anhand des Fehlermodus verzweigen können, statt Zeichenketten zu parsen.

Make-Szenario: Fehlerbehandlung mit Verzweigung bei OutOfMoneyError
HTTPMake-FehlertypWann es ausgelöst wird
400DataErrorSchema nicht gefunden, fehlende Suchschlüssel, ungültige Modelle oder Sprachen.
401InvalidCredentialsUngültiger oder fehlender API-Schlüssel.
402OutOfMoneyErrorPlanlimit überschritten ODER unzureichende Credits. Message = body.detail.detail (menschenlesbar, enthält bei insufficient_credits eine Aufladungs-URL) + body.detail.code (maschinenlesbar). Verzweigen Sie anhand des Codes: insufficient_credits, model_limit_exceeded, language_limit_exceeded, concurrent_job_limit_reached, daily/weekly/monthly_prompt_limit_exceeded.
403AccessDeniedErrorRolle oder Geltungsbereich unzureichend.
404InvalidConfigurationErrorSchema oder Datensatz nicht gefunden.
422DataErrorKlassifizierungswarnung. body.detail.classification enthält status, reasoning, confidence, entity_description.
429RateLimitErrorProvider-Ratenbegrenzung (vorübergehend).
499RuntimeErrorJob abgebrochen.
502ConnectionErrorUpstream-LLM-Provider-Fehler (z. B. Kontextüberlauf).
504ConnectionErrortimeout_seconds abgelaufen; Auftrag serverseitig automatisch abgebrochen.

Workflow-Ideen

CRM-EnrichmentBei neuen HubSpot-/Salesforce-Kontakten auslösen, mit Unternehmensdaten anreichern, den CRM-Datensatz aktualisieren.
Tabellen-PipelineEntitäten aus Google Sheets lesen, Iterator + Enrich Entity, die Ergebnisse in ein neues Sheet zurückschreiben.
Bedingte erneute ArbitrierungFühren Sie zuerst die regelbasierte Fusion aus; wenn conflicted_fields > 5, führen Sie über „Ergebnisse zusammenführen“ eine erneute Zusammenführung mit einem LLM-Arbiter durch – ohne die kostspielige Anreicherung erneut auszuführen.
Plan-Limit-RoutingBei einem OutOfMoneyError einen Mitarbeiter in Slack benachrichtigen und das Szenario pausieren, bis das Kontingentfenster zurückgesetzt wird.
Geplante AktualisierungNach einem Cron-Zeitplan ausführen (Make-Schedule-Trigger), um veraltete Datensätze mit den neuesten Modellen neu anzureichern.

Nächste Schritte