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 10 operaciones en 6 categorías de recursos:
| Recurso | Operación | Descripción |
|---|---|---|
| Enrichment | Enrich Entity | Enriquezca una sola entidad con uno o más modelos de IA. Transmite los resultados mediante SSE con progreso en tiempo real. |
| Enrichment | Batch Enrich | Enriquezca todos los elementos de entrada como un único lote. Procesamiento en paralelo con seguimiento de progreso por entidad. |
| 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. |
| 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. |
| Fusion | Merge Results | Fusione resultados de varios registros de enriquecimiento con arbitraje LLM opcional. |
| Attachment | Add Attachment | Suba una propiedad binaria del elemento de entrada (multipart) y obtenga su ID de adjunto. |
| Attachment | Delete Attachment | Elimine un adjunto por ID: un práctico paso de limpieza posterior al enriquecimiento. |
| Configuration | Get Options | Obtenga los modelos, idiomas, estrategias y límites de plan disponibles para la configuración dinámica. |
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
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.
Proporcione un campo IDs de adjuntos (UUID separados por comas de llamadas anteriores de Agregar adjunto) para incorporar documentos de origen al enriquecimiento; también disponible en Enriquecimiento por lotes.
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
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.
Ideas de flujos de trabajo
Patrones comunes para crear canalizaciones de enriquecimiento con n8n: