Connettore n8n
Il nodo community di Entity Enricher per n8n consente di creare pipeline di arricchimento automatizzate con un editor visuale drag-and-drop. Consente di connettersi a oltre 400 app senza scrivere codice.
Installazione
Installa il nodo community nella tua istanza n8n:
npm install n8n-nodes-entity-enricher
Oppure installatelo tramite l'interfaccia di n8n: andate su Impostazioni → Community Nodes e cercate n8n-nodes-entity-enricher.
Prerequisiti
ent_XXXXXXXXXXXX.https://entityenricher.ai o il vostro URL self-hosted).Operazioni disponibili
Il connettore espone 10 operazioni su 6 categorie di risorse:
| Risorsa | Operazione | Descrizione |
|---|---|---|
| Enrichment | Enrich Entity | Arricchisci una singola entità con uno o più modelli di IA. Trasmette i risultati in streaming tramite SSE con avanzamento in tempo reale. |
| Enrichment | Batch Enrich | Arricchisci tutti gli elementi in input come un unico batch. Elaborazione parallela con monitoraggio dell'avanzamento per entità. |
| Schema | List Schemas | Elenca gli schema salvati disponibili per la selezione nei flussi di lavoro di arricchimento. |
| Schema | Get Schema Details | Recupera il contenuto completo dello schema con le proprietà chiave estratte per uno schema specifico. |
| Record | List Records | Interrogate i record di arricchimento con filtri per tipo ed esito. Risultati impaginati. |
| Record | Get Record | Recupera un risultato di arricchimento specifico tramite ID con output strutturato completo. |
| Fusion | Merge Results | Fondi i risultati di più record di arricchimento con arbitraggio LLM opzionale. |
| Attachment | Add Attachment | Carica una proprietà binaria dall'elemento di input (multipart) e restituisce il relativo ID allegato. |
| Attachment | Delete Attachment | Elimina un allegato tramite ID — un comodo passaggio di pulizia post-arricchimento. |
| Configuration | Get Options | Recupera modelli, lingue, strategie e limiti del piano disponibili per la configurazione dinamica. |
Arricchimento di entità singola
Il flusso di lavoro più semplice: attivazione su nuovi dati, arricchimento di una singola entità e invio del risultato alla destinazione. Il nodo attende il completamento dell'intero arricchimento prima di passare l'output strutturato a valle.
Flusso di lavoro di esempio — enrichment di una singola entità:
Configurazione del nodo — operazione Enrich Entity:
Configurazione
Seleziona uno schema dal menu a discesa dinamico, scegli uno o più modelli e fornisci i dati dell'entità come campi chiave-valore. Il nodo popola automaticamente i campi chiave di ricerca in base allo schema selezionato.
Le impostazioni opzionali includono strategia (a passaggio singolo o multi-competenza), lingue per l'output multilingue, modello di classificazione per la verifica del tipo di entità, modello di arbitrato per la risoluzione dei conflitti multi-modello e gli interruttori schema di risposta / output strutturato rigoroso che impongono un output conforme allo schema sui modelli compatibili.
Fornisci un campo ID attachment (UUID separati da virgola dalle precedenti chiamate Add Attachment) per inserire documenti di origine nell'enrichment, disponibile anche in Batch Enrich.
Arricchimento in batch
Elabora tutti gli elementi di input come un unico batch. Ideale per l'enrichment di elenchi da fogli di calcolo, database o risposte API. Tutte le entity vengono elaborate in parallelo con limitazione della frequenza per provider.
Configurazione del nodo — operazione Batch Enrich:
Come funziona la modalità batch
- Raccolta degli elementi — Il nodo raccoglie tutti gli elementi in ingresso dal nodo precedente (ad es. righe di un foglio di calcolo).
- Avvia lavoro batch — Tutte le entità vengono inviate tramite
POST /api/batch/started elaborate in parallelo. - Avanzamento in streaming — Il nodo consuma lo stream SSE finché tutte le entità non vengono completate o non viene raggiunto il timeout.
- Risultati di output — Un elemento di output per ogni entity con i dati strutturati arricchiti, pronti per l'elaborazione a valle.
Funzionalità principali
Menu a discesa dinamici
I selettori di schema, modello, lingua e strategia recuperano le opzioni dalla tua istanza Entity Enricher al momento della configurazione.
Streaming SSE
Le operazioni di arricchimento consumano lo stream SSE in tempo reale, attendendo il completamento prima di restituire i risultati al nodo successivo.
Continuazione automatica
Quando la classificazione preliminare rileva una discrepanza, il connettore prosegue automaticamente (i flussi di lavoro n8n non sono interattivi).
Timeout configurabile
Timeout predefinito di 300 secondi per chiamata di arricchimento, regolabile per nodo per schemi di grandi dimensioni o modelli lenti.
Supporto multi-modello
Seleziona più modelli per enrichment. Quando vengono utilizzati 2+ modelli, i risultati vengono fusi automaticamente.
Pulisci output per impostazione predefinita
Per impostazione predefinita, l'output contiene solo i campi dati arricchiti. Attiva "Includi metadati di arricchimento" per aggiungere costo, token, dettagli della fusione e ID dei record.
Output per modello
Facoltativamente, restituisce i risultati dei singoli modelli insieme al risultato fuso per un confronto a valle.
Consapevolezza dei limiti del piano
I menu a discesa del modello e della lingua mostrano i limiti del piano quando configurati. Gli errori HTTP 402 dovuti all'applicazione delle quote vengono presentati come messaggi chiari e utilizzabili, con i dettagli dei limiti. L'output dei metadati include i limiti attuali del piano per l'instradamento a valle.
Idee per workflow
Pattern comuni per la creazione di pipeline di arricchimento con n8n: