Conector do Make.com
Basta colocar um único módulo Make num cenário, mapear uma entidade de um passo anterior e receber um objeto JSON estruturado, validado pelo esquema e resultante da fusão de vários modelos — com saída multilingue em 40 idiomas produzida numa única passagem do LLM. São 15 módulos de primeira classe, com menus dinâmicos e tratamento de erros ciente dos 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 está no repositório público TOT-Concept (sincronizado a partir do monorepo do Entity Enricher). Enquanto a aplicação não chega ao marketplace da Make.com, 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 — uma ligação por API Key utilizando uma chave de Entity Enricher → Definições → API Keys (formato
ent_XXXXXXXXXXXX, testada automaticamente em/api/enrichment/options), ou uma ligação OAuth 2.0: inicie sessão em Entity Enricher e clique em Autorizar.
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:
identity_merges— cada vez que esta execução reutilizou uma identidade existente que tinha sido criada a partir de palavras diferentes, com a semelhança que a determinou (vazio quando a decisão coube a uma correspondência exata de código ou token, uma vez que não foi medida qualquer semelhança).entity_keys— os valores da coluna de chave efetivamente guardados, para que um módulo a jusante possa referenciar a linha que acabou de criar sem adivinhar.- Um
estadode escrita na base de dados que reporta honestamente uma escrita parcial, em vez de a dar como simples sucesso, juntamente comskipped_itemsekey_collisions. - Nos registos:
retries, que substituiu o antigo campoattempts— uma renomeação disruptiva, por isso atualize qualquer cenário que o mapeasse.
Módulos disponíveis
15 módulos em 7 categorias. Os módulos Search emitem um bundle por resultado para cadeias Iterator/Aggregator a jusante; os módulos Action 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. |
| Schemas | Generate Sample | Gere 1..N objetos JSON de amostra realistas de um tipo de entidade numa única chamada bloqueante — o ponto de entrada da criação de esquemas. A primeira amostra define o conjunto de campos; as restantes são variantes de instância com os mesmos campos. |
| Schemas | Generate Schema | Gere e guarde automaticamente um esquema JSON a partir de 1..N objetos de amostra do mesmo tipo de entidade — união de campos, anulável quando um campo está em falta nalguma amostra, valores reais observados como exemplos. |
| 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. |
| Records | Inject Records into 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 do schema e depois passado pelo controlo de admissão. |
| 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. |
| Database Sync | List Database Syncs | Devolve as database syncs de um esquema, com as contagens de deltas pendentes. |
| Database Sync | Fetch Database Deltas | Devolve a próxima janela FIFO de deltas SQL para uma database sync. Com Claim ativado, as linhas são reservadas (lease) e têm de ser confirmadas; caso contrário, a leitura é repetível. |
| Database Sync | Acknowledge Database Deltas | Confirma 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 | Modelos, idiomas e estratégias disponíveis, e os limites do plano da organização. |
Os módulos Database Sync alimentam o feed de deltas da sincronização da base de dados a partir de um cenário agendado: Fetch Database Deltas reserva a janela SQL seguinte, um módulo de base de dados ou HTTP aplica-a e Acknowledge Database Deltas confirma-a (mapeie o Next Cursor de Fetch para Acknowledge).
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.
Simples por predefinição
O módulo Enrich Entity abre apenas com dados da entidade, schema, idiomas e pesquisa web — o Entity Enricher é executado automaticamente com o melhor modelo da sua organização. Os modelos, anexos, estratégia e as opções de classificação/arbitragem ficam por detrás do botão "Show advanced settings" do Make.
Menus pendentes dinâmicos (RPCs)
10 RPCs obtêm esquemas, database syncs, modelos, idiomas, estratégias, modelos de classificação/arbitragem e opções de esquema de resposta e de saída estruturada 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, method, arbitration_model}.
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. |
Começar a partir de um cenário de exemplo
A aplicação inclui seis blueprints de cenário importáveis — enriquecimento único, o padrão de lote com Iterator, documento para enriquecimento, imagem para amostra para esquema, amostras para esquema e esvaziamento do feed de deltas de uma sincronização da base de dados. Importe um e substitua pela sua própria ligação, em vez de montar os módulos de raiz.