Conector do Make.com
Coloque um único módulo Make em qualquer cenário, mapeie uma entidade de um passo anterior e receba um objeto JSON estruturado, validado por esquema e fundido a partir de vários modelos — com saída multilingue em 40 idiomas produzida numa única passagem do LLM. 9 módulos de primeira classe com menus pendentes dinâmicos e tratamento de erros sensível aos limites do plano, concebidos para o modelo de faturação por operação do Make.
Concebido para Make
O Entity Enricher já disponibiliza um conector n8n que consome um stream de Server-Sent Events. Os módulos do Make não conseguem consumir SSE nativamente — cada módulo é uma única chamada HTTP atómica. Para suportar o enriquecimento como uma única operação do Make, o backend expõe um endpoint dedicado POST /api/single/enrich/sync que encapsula o fluxo de streaming no lado do servidor e devolve o resultado final combinado numa só resposta.
Enriquecimento Multilingue numa Única Passagem
Escolha mais do que um idioma no campo Idiomas e o Entity Enricher preenche todas as propriedades multilingues em todos os idiomas selecionados numa única chamada LLM — e não N idas e voltas sequenciais por idioma. 40 idiomas cobrem os principais mercados europeus, asiáticos, do Médio Oriente e africanos.
Resultado de uma chamada Enrich Entity com languages = ["en", "fr", "de", "ja"]:
{
"names": {
"primary": {
"en": "Aspirin",
"fr": "Aspirine",
"de": "Aspirin",
"ja": "アスピリン"
}
},
"indications": {
"en": "Pain, fever, inflammation; antiplatelet therapy.",
"fr": "Douleur, fièvre, inflammation ; antiagrégant plaquettaire.",
"de": "Schmerz, Fieber, Entzündung; Thrombozytenaggregationshemmer.",
"ja": "痛み、発熱、炎症;抗血小板療法。"
}
}Os módulos Make a jusante podem mapear qualquer idioma diretamente: {{enrichEntity.result.names.primary.fr}}. O menu pendente de idiomas apresenta a lista completa de 40 idiomas, com um aviso de limite de plano quando o perfil da sua organização restringe o número de idiomas selecionáveis.
Instalação
O código-fonte da aplicação Make encontra-se no repositório público TOT-Concept (sincronizado a partir do monorepo do Entity Enricher). Até que a v1.0 chegue ao marketplace do Make, faça sideload através do Developer Hub:
- Inicie sessão na sua organização Make como programador.
- Aceda a Apps → Create a new app → Custom App.
- Carregue o diretório
make-app-entity-enricher/como um.zipou cole cada ficheiro.json/.imljsonno respetivo separador do editor. - Adicione uma ligação por chave de API usando uma chave de Entity Enricher → Definições → Chaves de API (formato
ent_XXXXXXXXXXXX). A ligação é testada automaticamente em/api/enrichment/options.
Menus pendentes dinâmicos
Cada campo selecionável nos módulos do Make.com é preenchido por um RPC que consulta a API do Entity Enricher no momento da configuração. Os schemas afixados aparecem primeiro (marcados com 📌), as etiquetas dos modelos incluem o preço por milhão de tokens e as organizações com plano limitado veem um aviso quando atingem a sua quota.
Pré-requisitos
https://entityenricher.ai. Substitua apenas em implementações self-hosted.Enriquecer Entidade em Ação
O módulo central expõe os seus campos de entrada com menus pendentes dinâmicos: schema, modelos (seleção múltipla), idiomas (seleção múltipla), estratégia, modelos opcionais de classificação e arbitragem, pesquisa web, schema de resposta, saída estruturada estrita, tempo limite e opções de metadados. Mapeie uma entidade a partir de qualquer módulo anterior através do campo Entity data.
Quando 2+ modelos são selecionados, o resultado é automaticamente fundido no servidor. O painel de saída do Make mostra is_fused: true, a lista de source_models e um resumo de fusion que conta os campos concordantes e em conflito:
Módulos disponíveis
9 módulos em 5 categorias. Os módulos de pesquisa emitem um bundle por resultado para as cadeias Iterator/Aggregator subsequentes; os módulos de ação emitem um único bundle.
| Categoria | Módulo | Descrição |
|---|---|---|
| Enrichment | Enrich Entity | Enriquecimento numa única chamada com fusão multimodelo. Devolve o resultado final fundido (ou do melhor modelo único). Cancela automaticamente perante um aviso de classificação. |
| Schemas | List Schemas | Devolve um bundle Make por esquema guardado, pronto para cadeias Iterator/Aggregator. |
| Schemas | Get Schema Details | Conteúdo completo do esquema, incluindo domínios de especialização, propriedades e chaves de pesquisa. |
| Records | List Records | Pesquise registos de enriquecimento anteriores com filtros (tipo, sucesso, texto livre). |
| Records | Get Record | Obter um único resultado de enriquecimento com métricas completas por prompt. |
| Fusion | Merge Results | Voltar a combinar vários resultados de enrichment, opcionalmente com um árbitro LLM diferente. |
| Attachments | Upload Attachment | Carregar um ficheiro (mapeado como buffer a partir de um módulo anterior, por exemplo, HTTP ▸ Get a File) e devolver o respetivo ID de anexo para utilização em Enrich Entity. |
| Attachments | Delete Attachment | Eliminar um anexo por ID — um passo prático de limpeza pós-enriquecimento. |
| Configuration | Get Options | Modelos, idiomas e estratégias disponíveis, e os limites do plano da organização. |
Fluxos de trabalho multi-entidade: padrão Iterador
Os cenários do Make são faturados por operação. Em vez de portar o módulo Batch Enrich do conector do n8n, a aplicação do Make usa o Iterator + Enrich Entity integrados no Make. Cada iteração é independente, as falhas não se propagam em cascata e a faturação reflete exatamente o que foi processado.
Principais funcionalidades
Multilingue em 40 Idiomas
Uma única chamada Enrich Entity preenche todas as propriedades multilingues em todos os idiomas selecionados — produzidas numa só passagem do LLM, não em N idas e voltas sequenciais. Mapeie qualquer idioma diretamente: {{result.names.primary.fr}}.
Enriquecimento de Uma Chamada
Um endpoint POST /api/single/enrich/sync dedicado encapsula o fluxo de streaming no lado do servidor. Uma operação Make = um bundle. Sem polling, sem padrões de dois módulos.
Menus pendentes dinâmicos (RPCs)
7 RPCs obtêm esquemas, modelos, idiomas, estratégias, modelos de classificação/arbitragem e opções de pesquisa web no momento da configuração — os esquemas fixados aparecem primeiro e as etiquetas dos modelos incluem os preços.
Auto-fusão multi-modelo
Escolha 2 ou mais modelos e o resultado é automaticamente fundido. O pacote de saída inclui is_fused, source_models[] e um resumo fusion: {agreed_fields, conflicted_fields, total_fields}.
Classificação prévia
Um modelo de classification barato e opcional verifica se a entity corresponde ao tipo esperado pelo schema antes de o enrichment ser executado. As incompatibilidades produzem um DataError tipado em vez de dados alucinados.
Consciência do Limite do Plano e dos Créditos
Os erros HTTP 402 (limites do plano ou credits insuficientes) tornam-se um Make OutOfMoneyError tipado. A mensagem reflete o detalhe legível do backend (com um URL de recarga de faturação quando os credits acabam) mais um código legível por máquina — ramifique o gestor de erros do scenario com base no código para alertar humanos, recorrer a modelos mais baratos ou fazer uma pausa.
Bloqueios do Menu de Pesquisa Web
O menu pendente de Pesquisa na Web lê parameters.models e desativa-se quando nenhum dos modelos selecionados declara supports_web_search.
Sem Módulo de Batch
Os cenários do Make são faturados por operação. Os fluxos de trabalho com várias entidades usam o Iterator + Enrich Entity integrados no Make, proporcionando um tratamento de erros granular por entidade e uma faturação exata.
Tempo limite configurável
Tempo limite predefinido de 300 segundos por chamada, limitado a [10, 900]. A tarefa é cancelada automaticamente no servidor se não terminar a tempo, devolvendo um ConnectionError tipado.
Contrato de erro
Cada estado que o backend pode devolver é mapeado para um erro tipado do Make.com, para que os gestores de erros de cenário possam ramificar consoante o modo de falha em vez de analisar strings.
| HTTP | Tipo de erro do Make | Quando é acionado |
|---|---|---|
| 400 | DataError | Esquema não encontrado, chaves de pesquisa em falta, modelos ou idiomas inválidos. |
| 401 | InvalidCredentials | Chave de API incorreta ou em falta. |
| 402 | OutOfMoneyError | Limite do plano excedido OU créditos insuficientes. Mensagem = body.detail.detail (legível por humanos, inclui um URL de recarga para insufficient_credits) + body.detail.code (legível por máquina). Ramifique conforme o código: insufficient_credits, model_limit_exceeded, language_limit_exceeded, concurrent_job_limit_reached, daily/weekly/monthly_prompt_limit_exceeded. |
| 403 | AccessDeniedError | Função ou âmbito insuficiente. |
| 404 | InvalidConfigurationError | Esquema ou registo não encontrado. |
| 422 | DataError | Aviso de classificação. body.detail.classification transporta status, reasoning, confidence, entity_description. |
| 429 | RateLimitError | Limite de taxa do fornecedor (transitório). |
| 499 | RuntimeError | Tarefa cancelada. |
| 502 | ConnectionError | Erro do provider de LLM a montante (por exemplo, contexto excedido). |
| 504 | ConnectionError | timeout_seconds decorrido; tarefa cancelada automaticamente no lado do servidor. |