Conector de n8n
El nodo comunitario de Entity Enricher para n8n le permite crear flujos de enriquecimiento automatizados con un editor visual de arrastrar y soltar. Conéctese a más de 400 aplicaciones sin escribir código.
Instalación
Instale el nodo comunitario en su instancia de n8n:
npm install n8n-nodes-entity-enricher
O instálelo desde la interfaz de n8n: vaya a Ajustes → Nodos de la comunidad y busque n8n-nodes-entity-enricher.
Requisitos previos
ent_XXXXXXXXXXXX.https://entityenricher.ai o su URL autoalojada).Operaciones disponibles
El conector expone 18 operaciones en 7 categorías de recursos:
| Recurso | Operación | Descripción |
|---|---|---|
| Enrichment | Enrich Entity | Enriquezca una sola entidad: solo elija un schema; el mejor modelo y la mejor estrategia de su organización se seleccionan automáticamente. Transmite los resultados mediante SSE con progreso en tiempo real. |
| Enrichment | Enrich Entity Advanced | Enriquezca una sola entidad con control total sobre modelos, fusion, estrategia, classification y salida estructurada. |
| Enrichment | Batch Enrich | Enriquezca todos los elementos de entrada como un único batch con el modelo y la estrategia automáticos. Procesamiento en paralelo con seguimiento del progreso por entidad. |
| Enrichment | Batch Enrich Advanced | Enriquezca todos los elementos de entrada como un único batch con el conjunto completo de parámetros. |
| Schema | List Schemas | Lista los esquemas guardados disponibles para seleccionarlos en los flujos de trabajo de enriquecimiento. |
| Schema | Get Schema Details | Recupera el contenido completo del schema con las propiedades clave extraídas para un schema específico. |
| Schema | Generate Sample | Genere 1..N objetos JSON de muestra realistas de un mismo tipo de entidad en un solo trabajo: el punto de entrada del ciclo de creación de esquemas. El idioma es «auto» de forma predeterminada, inferido a partir de las palabras de su propia solicitud. |
| Schema | Generate Schema | Genera y guarda automáticamente un esquema JSON: cada elemento de entrada es una muestra del mismo tipo de entidad; unión de campos, anulables cuando un campo falta en alguna muestra y valores reales observados como ejemplos. Una opción de idioma define el idioma en el que el esquema se describe a sí mismo. |
| Record | List Records | Consulte los registros de enriquecimiento con filtros de tipo y de éxito. Resultados paginados. |
| Record | Get Record | Recupera un resultado de enrichment específico por ID con la salida estructurada completa. |
| Record | Sync Records to Database | Envíe una salida de enriquecimiento almacenada (o transformada) a la sincronización de base de datos de su esquema — se revalida con el contrato publicado y luego pasa por la puerta de admisión. |
| Fusion | Merge Results | Fusione resultados de varios registros de enriquecimiento con arbitraje LLM opcional. |
| Attachment | Add Attachment | Sube uno o varios archivos binarios del elemento de entrada (solicitud multipart única) y devuelve un elemento por cada ID de adjunto. |
| Attachment | Delete Attachment | Elimine un adjunto por ID: un práctico paso de limpieza posterior al enriquecimiento. |
| Database Sync | List Database Syncs | Enumera las sincronizaciones de base de datos registradas en un esquema, con el número de deltas pendientes. |
| Database Sync | Fetch Deltas | Obtiene la siguiente ventana FIFO de deltas de base de datos (SQL + JSON), con la opción de reservarlos mediante lease para su confirmación. |
| Database Sync | Acknowledge Deltas | Confirme los deltas aplicados hasta un ID: libera el lease y, según las opciones de sincronización, purga las copias entregadas. |
| Configuration | Get Options | Obtenga los modelos, idiomas, estrategias y límites de plan disponibles para la configuración dinámica. |
Nodo disparador
El paquete también incluye un nodo Entity Enricher Trigger independiente: un disparador de webhook que inicia un flujo de trabajo ante eventos de esquema y registra su suscripción automáticamente:
Junto con las operaciones de Database Sync, el disparador mantiene una base de datos externa convergente únicamente desde n8n; consulte la documentación de Database Sync.
Enriquecimiento de una sola entidad
El flujo de trabajo más sencillo: se activa con datos nuevos, enriquece una única entidad y envía el resultado a su destino. El nodo espera a que se complete el enriquecimiento completo antes de pasar la salida estructurada aguas abajo.
Flujo de trabajo de ejemplo: enriquecimiento de una sola entidad:
Configuración del nodo: operación de enrichment de entity:
Configuración
Las operaciones predeterminadas Enrich Entity y Batch Enrich muestran solo lo esencial: schema, carga de archivos, idiomas y búsqueda web. Entity Enricher se ejecuta automáticamente con el mejor modelo de su organización —su modelo predeterminado fijado o el modelo con la mejor puntuación de benchmark— y elige la estrategia de enrichment a partir de su schema. Las operaciones Enrich Entity Advanced y Batch Enrich Advanced exponen el conjunto completo de opciones que aparece a continuación.
Seleccione un schema del menú desplegable dinámico, elija uno o más modelos y proporcione los datos de la entidad como campos clave-valor. El nodo rellena automáticamente los campos de clave de búsqueda según el schema seleccionado.
Los ajustes opcionales incluyen estrategia (paso único o multidominio de especialización), idiomas para salida multilingüe, modelo de clasificación para la verificación del tipo de entidad, modelo de arbitraje para la resolución de conflictos entre varios modelos, y las opciones de esquema de respuesta / salida estructurada estricta que imponen una salida conforme al esquema en los modelos compatibles.
Para incorporar documentos de origen al enriquecimiento, active Upload Input Binary Files: el nodo carga los archivos binarios del elemento de entrada como adjuntos en una única solicitud (todos ellos, o solo los indicados en Binary Fields to Upload) y, con Delete Uploaded Attachments After Enrichment (activado de forma predeterminada), los elimina una vez que finaliza el enriquecimiento — sin necesidad de pasos independientes de Add Attachment / Delete Attachment. Como alternativa, indique un campo Attachment IDs (UUID separados por comas procedentes de llamadas anteriores a Add Attachment) para reutilizar en muchos enriquecimientos documentos cargados una sola vez; ambas fuentes pueden combinarse. También está disponible en Batch Enrich, donde los archivos se recopilan de todos los elementos de entrada y se aplican a cada entidad del trabajo. Si un nodo Edit Fields se sitúa entre la fuente de archivos y el nodo de enriquecimiento, active su opción Include Other Input Fields — de lo contrario, eliminará los datos binarios.
Enriquecimiento por lotes
Procese todos los elementos de entrada como un único batch. Ideal para enriquecer listas de hojas de cálculo, bases de datos o respuestas de API. Todas las entidades se procesan en paralelo con limitación de frecuencia por proveedor.
Configuración del nodo: operación de enrichment por batch:
Cómo funciona el modo por lotes
- Recopilar elementos — El nodo reúne todos los elementos de entrada del nodo anterior (p. ej., filas de una hoja de cálculo).
- Iniciar trabajo por lote — Todas las entidades se envían mediante
POST /api/batch/starty se procesan en paralelo. - Progreso en streaming — El nodo consume el flujo SSE hasta que todas las entidades se completan o se alcanza el tiempo de espera.
- Resultados de salida — Un elemento de salida por entidad con los datos estructurados enriquecidos, listos para el procesamiento posterior.
Características clave
Operaciones simples y avanzadas
Las operaciones predeterminadas Enrich Entity y Batch Enrich muestran solo el schema, la carga de archivos, los idiomas y la búsqueda web; el mejor modelo y la mejor estrategia se seleccionan automáticamente. Las operaciones avanzadas ofrecen control total sobre modelos, fusion, estrategia y salida estructurada.
Menús desplegables dinámicos
Los selectores de esquema, modelo, idioma y estrategia obtienen las opciones de su instancia de Entity Enricher en el momento de la configuración.
Streaming SSE
Las operaciones de enriquecimiento consumen el flujo SSE en tiempo real, esperando a que se completen antes de devolver los resultados al siguiente nodo.
Continuación automática
Cuando la classification previa detecta una discordancia, el conector continúa automáticamente (los flujos de n8n no son interactivos).
Tiempo de espera configurable
Tiempo de espera predeterminado de 300 segundos por llamada de enriquecimiento, ajustable por nodo para esquemas grandes o modelos lentos.
Compatibilidad multimodelo
Seleccione varios modelos por enriquecimiento. Cuando se usan 2 o más modelos, los resultados se fusionan automáticamente.
Limpiar salida de forma predeterminada
De forma predeterminada, el resultado contiene únicamente los campos de datos enriquecidos. Active «Incluir metadatos de enriquecimiento» para añadir el coste, los tokens, los detalles de fusión y los ID de registro.
Salida por modelo
Opcionalmente, genere los resultados de cada modelo junto con el resultado fusionado para su comparación posterior.
Conocimiento de los límites del plan
Los menús desplegables de modelo e idioma muestran los límites del plan cuando están configurados. Los errores HTTP 402 derivados de la aplicación de cuotas se presentan como mensajes claros y accionables con los detalles del límite. La salida de metadatos incluye los límites actuales del plan para el enrutamiento posterior.
Úselo desde un agente de IA o parta de un ejemplo
Una herramienta de agente de IA
El nodo Entity Enricher se puede adjuntar como herramienta a un AI Agent de n8n, de modo que el agente decida por sí mismo cuándo enriquecer una entidad u obtener un esquema en mitad de una conversación. El nodo disparador no se ofrece así de forma deliberada: un disparador inicia un flujo de trabajo, no es algo que un agente invoque.
Seis flujos de trabajo importables
El paquete incluye archivos de flujo de trabajo listos para usar: enriquecimiento individual, lote, documento a enriquecimiento, imagen a muestra a esquema, muestras a esquema y vaciado de un feed de deltas en PostgreSQL. Importe uno y sustituya la credencial por la suya en lugar de configurarlo desde cero.
Ideas de flujos de trabajo
Patrones comunes para crear canalizaciones de enriquecimiento con n8n: