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 18 operações em 7 categorias de recursos:
| Recurso | Operação | Descrição |
|---|---|---|
| Enrichment | Enrich Entity | Enriqueça uma única entidade — basta escolher um esquema; o melhor modelo e estratégia da sua organização são selecionados automaticamente. Transmite os resultados via SSE com progresso em tempo real. |
| Enrichment | Enrich Entity Advanced | Enriqueça uma única entidade com controlo total sobre modelos, fusão, estratégia, classificação e saída estruturada. |
| Enrichment | Batch Enrich | Enriqueça todos os itens de entrada como um único lote com o modelo e estratégia automáticos. Processamento paralelo com acompanhamento de progresso por entidade. |
| Enrichment | Batch Enrich Advanced | Enriqueça todos os itens de entrada como um único lote com o conjunto completo de parâmetros. |
| 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. |
| Schema | Generate Sample | Gere 1..N objetos JSON de amostra realistas de um tipo de entidade num único trabalho — o ponto de entrada do ciclo de criação de esquemas. O idioma assume por predefinição auto, inferido a partir das palavras do seu próprio pedido. |
| Schema | Generate Schema | Gere e guarde automaticamente um esquema JSON — cada item de entrada é uma amostra do mesmo tipo de entidade: união dos campos, anulável quando um campo falta nalguma amostra, valores reais observados como exemplos. Uma opção Idioma define o idioma em que o esquema se descreve a si próprio. |
| 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. |
| Record | Sync Records to Database | Envie um resultado de enriquecimento guardado (ou transformado) para a sincronização de base de dados do respetivo schema — revalidado face ao contrato publicado e depois passado pelo controlo de admissão. |
| Fusion | Merge Results | Funda resultados de vários registos de enriquecimento com arbitragem LLM opcional. |
| Attachment | Add Attachment | Carregue um ou mais ficheiros binários do item de entrada (pedido multipart único) e devolva um item por ID de anexo. |
| Attachment | Delete Attachment | Eliminar um anexo por ID — um passo prático de limpeza pós-enriquecimento. |
| Database Sync | List Database Syncs | Liste as database syncs registadas num esquema, com as contagens de deltas pendentes. |
| Database Sync | Fetch Deltas | Obtenha a próxima janela FIFO de deltas de base de dados (SQL + JSON), opcionalmente reservando-os (lease) para confirmação. |
| Database Sync | Acknowledge Deltas | Confirme os deltas aplicados até um ID — liberta o lease e, consoante as opções de sincronização, elimina as cópias entregues. |
| Configuration | Get Options | Obtenha os modelos, idiomas, estratégias e limites de plano disponíveis para configuração dinâmica. |
Nó acionador
O pacote inclui também um nó Entity Enricher Trigger separado — um acionador de webhook que inicia um fluxo de trabalho em eventos de esquema, registando a sua subscrição automaticamente:
Juntamente com as operações do Database Sync, o acionador mantém uma base de dados externa convergida apenas a partir do n8n — consulte a documentação do Database Sync.
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
As operações predefinidas Enrich Entity e Batch Enrich mostram apenas o essencial: esquema, carregamento de ficheiro, idiomas e pesquisa na web. O Entity Enricher é executado automaticamente com o melhor modelo da sua organização — a sua predefinição fixada ou o modelo com a pontuação de benchmark mais elevada — e escolhe a estratégia de enriquecimento a partir do seu esquema. As operações Enrich Entity Advanced e Batch Enrich Advanced expõem o conjunto completo de opções abaixo.
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.
Para fornecer documentos de origem ao enriquecimento, ative Carregar Ficheiros Binários de Entrada: o nó carrega os ficheiros binários do item de entrada como anexos num único pedido (todos eles, ou apenas os indicados em Campos Binários a Carregar) e, com Eliminar Anexos Carregados Após o Enriquecimento (ativado por predefinição), remove-os assim que o enriquecimento termina — sem necessidade de passos separados de Add Attachment / Delete Attachment. Em alternativa, forneça um campo IDs de Anexo (UUIDs separados por vírgulas de chamadas Add Attachment anteriores) para reutilizar documentos carregados uma só vez em vários enriquecimentos; ambas as fontes podem ser combinadas. Também disponível no Batch Enrich, onde os ficheiros são recolhidos de todos os itens de entrada e aplicados a todas as entidades do trabalho. Se um nó Edit Fields estiver entre a fonte dos ficheiros e o nó de enriquecimento, ative o respetivo interruptor Incluir Outros Campos de Entrada — caso contrário, remove os dados binários.
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
Operações Simples e Avançadas
As operações predefinidas Enrich Entity e Batch Enrich mostram apenas esquema, carregamento de ficheiro, idiomas e pesquisa na web — o melhor modelo e estratégia são selecionados automaticamente. As operações Advanced dão controlo total sobre modelos, fusão, estratégia e saída estruturada.
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.
Utilize-o a partir de um Agente de IA ou comece por um exemplo
Uma ferramenta de AI Agent
O nó Entity Enricher pode ser ligado a um AI Agent do n8n como ferramenta, permitindo que um agente decida por si quando enriquecer uma entidade ou obter um esquema a meio de uma conversa. O nó de gatilho não é deliberadamente disponibilizado desta forma — um gatilho inicia um workflow, não é algo que um agente invoque.
Seis fluxos de trabalho importáveis
O pacote inclui ficheiros de workflow prontos a usar — enriquecimento único, lote, documento para enriquecimento, imagem para amostra para esquema, amostras para esquema e esvaziamento de um feed de deltas para PostgreSQL. Importe um e substitua pela sua própria credencial, em vez de o montar de raiz.
Ideias de Fluxos de Trabalho
Padrões comuns para construir pipelines de enriquecimento com o n8n: