Conector de Make.com
Añada un único módulo de Make a cualquier escenario, asigne 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 generada en una sola pasada del LLM. 15 módulos de primer nivel con listas desplegables dinámicas y gestión de errores que tiene en cuenta 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 TOT-Concept (sincronizado desde el monorepo de Entity Enricher). Hasta que la app llegue al marketplace de Make, cárguela manualmente desde el 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: ya sea una conexión con clave de API usando una clave de Entity Enricher → Configuración → Claves de API (formato
ent_XXXXXXXXXXXX, probada automáticamente contra/api/enrichment/options), o una conexión OAuth 2.0: inicie sesión en Entity Enricher y haga clic en Autorizar.
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:
identity_merges: cada vez que esta ejecución reutilizó una identidad existente creada a partir de palabras distintas, junto con la similitud que lo determinó (vacío cuando la decisión la tomó una coincidencia exacta de código o de token, ya que no se midió ninguna similitud).entity_keys: los valores de las columnas clave realmente almacenados, para que un módulo posterior pueda dirigirse a la fila que acaba de crear sin adivinar.- Un
estadode escritura en base de datos que informa con honestidad de una escritura parcial en lugar de darla por correcta sin más, junto conskipped_itemsykey_collisions. - En los registros:
retries, que sustituyó al antiguo campoattempts— es un cambio de nombre incompatible, así que actualice cualquier escenario que lo mapeara.
Módulos disponibles
15 módulos repartidos en 7 categorías. Los módulos de búsqueda (Search) emiten un bundle por resultado para las cadenas Iterator/Aggregator posteriores; los módulos de acción (Action) 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. |
| Schemas | Generate Sample | Genera de 1 a N objetos JSON de muestra realistas de un tipo de entidad en una sola llamada bloqueante: el punto de entrada de la creación de esquemas. La primera muestra define el conjunto de campos; las demás son variantes de instancia con los mismos campos. |
| Schemas | Generate Schema | Genera y guarda automáticamente un esquema JSON a partir de 1 a N objetos de muestra del mismo tipo de entidad: unión de campos, anulable cuando un campo falta en alguna muestra y valores reales observados como ejemplos. |
| 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. |
| Records | Inject Records into Database | Envíe una salida de enriquecimiento almacenada (o transformada) a la sincronización de base de datos de su esquema. Se revalida con el contrato publicado del esquema y luego pasa por la puerta de admisión. |
| 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. |
| Database Sync | List Database Syncs | Devuelve las sincronizaciones de base de datos de un esquema, con el número de deltas pendientes. |
| Database Sync | Fetch Database Deltas | Devuelve la siguiente ventana FIFO de deltas SQL de una sincronización de base de datos. Con Claim habilitado, las filas se reservan mediante lease y deben confirmarse; de lo contrario, la lectura es reproducible. |
| Database Sync | Acknowledge Database Deltas | Confirma los deltas aplicados hasta un ID: libera el lease y, según las opciones de sincronización, purga las copias entregadas. |
| Configuration | Get Options | Modelos, idiomas y estrategias disponibles, y los límites del plan de la organización. |
Los módulos Database Sync alimentan el feed de deltas de sincronización de base de datos desde un escenario programado: Fetch Database Deltas reserva la siguiente ventana SQL, un módulo de base de datos o HTTP la aplica y Acknowledge Database Deltas la confirma (asigne el Next Cursor de Fetch a Acknowledge).
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.
Simple de forma predeterminada
El módulo Enriquecer entidad se abre solo con datos de entidad, esquema, idiomas y búsqueda web: Entity Enricher se ejecuta automáticamente con el mejor modelo de su organización. Los modelos, los adjuntos, la estrategia y las opciones de clasificación/arbitraje están detrás del interruptor «Mostrar configuración avanzada» de Make.
Menús desplegables dinámicos (RPC)
10 RPC recuperan esquemas, Database Syncs, modelos, idiomas, estrategias, modelos de clasificación/arbitraje y opciones de esquema de respuesta y de salida estructurada en el momento de la configuración: los esquemas fijados aparecen primero y las etiquetas de los modelos incluyen el precio.
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, method, arbitration_model}.
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. |
Empiece con un escenario de ejemplo
La aplicación incluye seis plantillas de escenario importables: enriquecimiento individual, el patrón de lote con Iterator, documento a enriquecimiento, imagen a muestra a esquema, muestras a esquema y vaciado del feed de deltas de una sincronización de base de datos. Importe una y sustituya la conexión por la suya en lugar de conectar los módulos desde cero.