Conector de Make.com
Coloque un único módulo de Make en cualquier escenario, mapee una entidad de un paso anterior y reciba un objeto JSON estructurado, validado contra el esquema y fusionado entre varios modelos, con salida multilingüe en 40 idiomas producida en una sola pasada del LLM. 9 módulos de primer nivel con menús desplegables dinámicos y gestión de errores según los límites del plan, diseñados para el modelo de facturación por operación de Make.
Diseñado para Make
Entity Enricher ya incluye un conector de n8n que consume un flujo de Server-Sent Events. Los módulos de Make no pueden consumir SSE de forma nativa: cada módulo es una única llamada HTTP atómica. Para admitir el enriquecimiento como una sola operación de Make, el backend expone un endpoint dedicado POST /api/single/enrich/sync que envuelve el flujo de streaming en el servidor y devuelve el resultado fusionado final en una sola respuesta.
Enriquecimiento multilingüe en una sola pasada
Elija más de un idioma en el campo Languages y Entity Enricher rellena todas las propiedades multilingües en todos los idiomas seleccionados en una sola llamada al LLM, en lugar de N idas y vueltas secuenciales por idioma. 40 idiomas cubren los principales mercados europeos, asiáticos, de Oriente Medio y africanos.
Resultado de una llamada a Enrich Entity con 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": "痛み、発熱、炎症;抗血小板療法。"
}
}Los módulos posteriores de Make pueden mapear cualquier idioma directamente: {{enrichEntity.result.names.primary.fr}}. El menú desplegable de Idiomas muestra la lista completa de 40 idiomas, con un aviso de límite de plan cuando el perfil de su organización restringe el número de idiomas seleccionables.
Instalación
El código fuente de la app de Make está en el repositorio público de TOT-Concept (sincronizado desde el monorepo de Entity Enricher). Hasta que la v1.0 llegue al marketplace de Make, cárguela de forma lateral a través del Developer Hub:
- Inicie sesión en su organización de Make como desarrollador.
- Vaya a Apps → Create a new app → Custom App.
- Suba el directorio
make-app-entity-enricher/como un.zip, o pegue cada archivo.json/.imljsonen su pestaña dentro del editor. - Agregue una conexión de clave API usando una clave de Entity Enricher → Configuración → Claves API (formato
ent_XXXXXXXXXXXX). La conexión se prueba automáticamente contra/api/enrichment/options.
Menús desplegables dinámicos
Cada campo seleccionable en los módulos de Make se rellena mediante un RPC que consulta la API de Entity Enricher en el momento de la configuración. Los esquemas fijados aparecen primero (marcados con 📌), las etiquetas de los modelos incluyen el precio por millón de tokens, y las organizaciones con plan limitado ven un aviso cuando alcanzan su cuota.
Requisitos previos
https://entityenricher.ai. Sustitúyala solo para despliegues autoalojados.Enriquecer entidad en acción
El módulo central expone sus campos de entrada con menús desplegables dinámicos: esquema, modelos (selección múltiple), idiomas (selección múltiple), estrategia, modelos opcionales de clasificación y arbitraje, búsqueda web, esquema de respuesta, salida estructurada estricta, tiempo de espera y opciones de metadatos. Asigne una entidad desde cualquier módulo anterior mediante el campo Datos de la entidad.
Cuando se seleccionan 2 o más modelos, el resultado se fusiona automáticamente en el servidor. El panel de salida de Make muestra is_fused: true, la lista de source_models y un resumen de fusion que cuenta los campos coincidentes y en conflicto:
Módulos disponibles
9 módulos en 5 categorías. Los módulos de búsqueda emiten un bundle por resultado para las cadenas Iterator/Aggregator posteriores; los módulos de acción emiten un único bundle.
| Categoría | Módulo | Descripción |
|---|---|---|
| Enrichment | Enrich Entity | Enriquecimiento en una sola llamada con fusión multimodelo. Devuelve el resultado final fusionado (o el del mejor modelo individual). Se cancela automáticamente ante una advertencia de clasificación. |
| Schemas | List Schemas | Devuelve un bundle de Make por cada schema guardado, listo para cadenas de Iterator/Aggregator. |
| Schemas | Get Schema Details | Contenido completo del esquema, incluidos dominios de especialización, propiedades y claves de búsqueda. |
| Records | List Records | Busque records de enrichment anteriores con filtros (tipo, éxito, texto libre). |
| Records | Get Record | Recupera un único resultado de enrichment con métricas completas por prompt. |
| Fusion | Merge Results | Vuelva a fusionar varios resultados de enriquecimiento, opcionalmente con un árbitro LLM diferente. |
| Attachments | Upload Attachment | Suba un archivo (asignado como búfer desde un módulo anterior, p. ej. HTTP ▸ Get a File) y obtenga su ID de adjunto para usar en Enrich Entity. |
| Attachments | Delete Attachment | Elimine un adjunto por ID: un práctico paso de limpieza posterior al enriquecimiento. |
| Configuration | Get Options | Modelos, idiomas y estrategias disponibles, y los límites del plan de la organización. |
Flujos de trabajo multientidad: patrón iterador
Los escenarios de Make se facturan por operación. En lugar de portar el módulo Batch Enrich del conector de n8n, la app de Make utiliza el Iterator integrado de Make + Enrich Entity. Cada iteración es independiente, los fallos no se propagan en cascada y la facturación refleja exactamente lo que se procesó.
Características clave
Multilingüe en 40 idiomas
Una sola llamada Enrich Entity rellena todas las propiedades multilingües en todos los idiomas seleccionados, generadas en una única pasada del LLM y no en N idas y vueltas secuenciales. Asigne cualquier idioma directamente: {{result.names.primary.fr}}.
Enriquecimiento de una llamada
Un endpoint dedicado POST /api/single/enrich/sync envuelve el flujo de streaming en el lado del servidor. Una operación de Make = un bundle. Sin sondeo, sin patrones de dos módulos.
Menús desplegables dinámicos (RPC)
7 RPC obtienen esquemas, modelos, idiomas, estrategias, modelos de clasificación/arbitraje y opciones de búsqueda web en el momento de la configuración: los esquemas fijados aparecen primero y las etiquetas de los modelos incluyen los precios.
Autofusión multimodelo
Elija 2 o más modelos y el resultado se fusiona automáticamente. El paquete de salida incluye is_fused, source_models[] y un resumen fusion: {agreed_fields, conflicted_fields, total_fields}.
Clasificación previa
Un modelo clasificador económico opcional verifica que la entidad coincide con el tipo esperado del esquema antes de ejecutar el enriquecimiento. Las discrepancias producen un DataError tipado en lugar de datos alucinados.
Conocimiento de límites del plan y créditos
Los errores HTTP 402 (límites del plan o créditos insuficientes) se convierten en OutOfMoneyError tipado de Make. El mensaje refleja el detalle legible del backend (con una URL de recarga de facturación cuando se acaban los créditos) más un código legible por máquina: ramifique el gestor de errores del escenario según el código para alertar a las personas, recurrir a modelos más económicos o pausar.
Bloqueos del menú desplegable de búsqueda web
El menú desplegable de Búsqueda web lee parameters.models y se desactiva cuando ninguno de los modelos seleccionados declara supports_web_search.
Sin módulo de batch
Los escenarios de Make se facturan por operación. Los flujos de trabajo con varias entidades utilizan el Iterator integrado de Make + Enrich Entity, lo que proporciona una gestión de errores granular por entidad y una facturación exacta.
Tiempo de espera configurable
Tiempo de espera predeterminado de 300 segundos por llamada, limitado a [10, 900]. El trabajo se cancela automáticamente en el servidor si no finaliza a tiempo, devolviendo un ConnectionError tipado.
Contrato de error
Cada estado que el backend puede devolver se asigna a un error tipado de Make para que los controladores de errores del escenario puedan ramificar según el modo de fallo en lugar de analizar cadenas de texto.
| HTTP | Tipo de error de Make | Cuándo se activa |
|---|---|---|
| 400 | DataError | Esquema no encontrado, faltan claves de búsqueda, modelos o idiomas no válidos. |
| 401 | InvalidCredentials | Clave de API incorrecta o ausente. |
| 402 | OutOfMoneyError | Se superó el límite del plan O créditos insuficientes. Message = body.detail.detail (legible por humanos, incluye una URL de recarga para insufficient_credits) + body.detail.code (legible por máquina). Ramifique según el código: insufficient_credits, model_limit_exceeded, language_limit_exceeded, concurrent_job_limit_reached, daily/weekly/monthly_prompt_limit_exceeded. |
| 403 | AccessDeniedError | Rol o alcance insuficiente. |
| 404 | InvalidConfigurationError | Esquema o registro no encontrado. |
| 422 | DataError | Advertencia de clasificación. body.detail.classification incluye status, reasoning, confidence, entity_description. |
| 429 | RateLimitError | Límite de frecuencia del proveedor (transitorio). |
| 499 | RuntimeError | Trabajo cancelado. |
| 502 | ConnectionError | Error del proveedor LLM upstream (p. ej., desbordamiento de contexto). |
| 504 | ConnectionError | timeout_seconds transcurridos; trabajo cancelado automáticamente en el servidor. |