Conector n8n
O nó comunitário do Entity Enricher para n8n permite-lhe criar pipelines de enriquecimento automatizados com um editor visual de arrastar e largar. Ligue-se a mais de 400 aplicações sem escrever código.
Instalação
Instale o nó comunitário na sua instância do n8n:
npm install n8n-nodes-entity-enricher
Ou instale através da interface do n8n: aceda a Definições → Community Nodes e procure por n8n-nodes-entity-enricher.
Pré-requisitos
ent_XXXXXXXXXXXX.https://entityenricher.ai ou o seu URL self-hosted).Operações disponíveis
O conector expõe 10 operações em 6 categorias de recursos:
| Recurso | Operação | Descrição |
|---|---|---|
| Enrichment | Enrich Entity | Enriqueça uma única entidade com um ou mais modelos de IA. Transmite os resultados via SSE com progresso em tempo real. |
| Enrichment | Batch Enrich | Enriqueça todos os itens de entrada como um único lote. Processamento paralelo com acompanhamento de progresso por entidade. |
| Schema | List Schemas | Listar os schemas guardados disponíveis para seleção nos fluxos de trabalho de enriquecimento. |
| Schema | Get Schema Details | Obter o conteúdo completo do esquema com as propriedades-chave extraídas de um esquema específico. |
| Record | List Records | Consulte registos de enriquecimento com filtros de tipo e de sucesso. Resultados paginados. |
| Record | Get Record | Obter um resultado de enriquecimento específico por ID com saída estruturada completa. |
| Fusion | Merge Results | Funda resultados de vários registos de enriquecimento com arbitragem LLM opcional. |
| Attachment | Add Attachment | Carregar uma propriedade binária do item de entrada (multipart) e devolver o respetivo ID de anexo. |
| Attachment | Delete Attachment | Eliminar um anexo por ID — um passo prático de limpeza pós-enriquecimento. |
| Configuration | Get Options | Obtenha os modelos, idiomas, estratégias e limites de plano disponíveis para configuração dinâmica. |
Enriquecimento de entidade individual
O fluxo de trabalho mais simples: acione com novos dados, enriqueça uma única entidade e envie o resultado para o seu destino. O nó aguarda a conclusão total do enriquecimento antes de passar a saída estruturada a jusante.
Exemplo de fluxo de trabalho — enriquecimento de uma única entidade:
Configuração do nó — operação de enriquecimento de entidade:
Configuração
Selecione um esquema na lista pendente dinâmica, escolha um ou mais modelos e forneça os dados da entidade como campos chave-valor. O nó preenche automaticamente os campos de chave de pesquisa com base no esquema selecionado.
As definições opcionais incluem estratégia (passagem única ou multi-expertise domain), idiomas para saída multilíngue, modelo de classification para verificação do tipo de entity, modelo de arbitration para resolução de conflitos entre múltiplos modelos e as opções de schema de resposta / saída estruturada estrita que impõem uma saída conforme ao schema em modelos capazes.
Forneça um campo IDs de anexo (UUIDs separados por vírgulas de chamadas anteriores de Adicionar anexo) para introduzir documentos de origem no enriquecimento — também disponível no Enriquecimento em lote.
Enriquecimento em Lote
Processe todos os itens de entrada como um único batch. Ideal para enriquecer listas de folhas de cálculo, bases de dados ou respostas de API. Todas as entidades são processadas em paralelo com limitação de taxa por provider.
Configuração do nó — operação de enriquecimento em lote:
Como funciona o Modo Batch
- Recolher itens — O nó reúne todos os itens de entrada do nó anterior (por exemplo, linhas de uma folha de cálculo).
- Iniciar tarefa em lote — Todas as entidades são submetidas via
POST /api/batch/starte processadas em paralelo. - Transmitir progresso — O nó consome o fluxo SSE até que todas as entidades terminem ou o tempo limite seja atingido.
- Resultados de saída — Um item de saída por entidade com os dados estruturados enriquecidos, prontos para processamento posterior.
Principais funcionalidades
Menus pendentes dinâmicos
Os seletores de esquema, modelo, idioma e estratégia obtêm as opções da sua instância de Entity Enricher no momento da configuração.
Streaming SSE
As operações de enriquecimento consomem o fluxo SSE em tempo real, aguardando a conclusão antes de devolver os resultados ao nó seguinte.
Continuação Automática
Quando a classification de pré-verificação deteta uma incompatibilidade, o conector continua automaticamente (os fluxos de trabalho do n8n são não interativos).
Tempo limite configurável
Tempo limite predefinido de 300 segundos por chamada de enriquecimento, ajustável por nó para esquemas grandes ou modelos lentos.
Suporte Multi-Modelo
Selecione vários modelos por enriquecimento. Quando são utilizados 2+ modelos, os resultados são automaticamente fundidos.
Limpar saída por predefinição
Por predefinição, o resultado contém apenas os campos de dados enriquecidos. Ative "Incluir Metadados de Enriquecimento" para adicionar custo, tokens, detalhes de fusão e IDs de registo.
Saída por modelo
Opcionalmente, produza os resultados individuais de cada modelo juntamente com o resultado de fusion para comparação posterior.
Consciência dos Limites do Plano
Os menus de model e de idioma apresentam os limites do plano quando configurados. Os erros HTTP 402 resultantes da aplicação de quotas são apresentados como mensagens claras e acionáveis, com os detalhes dos limites. Os metadados de saída incluem os limites atuais do plano para o encaminhamento a jusante.
Ideias de Fluxos de Trabalho
Padrões comuns para construir pipelines de enriquecimento com o n8n: