Detecte las propiedades del esquema cuyos valores varían entre modelos o entre ejecuciones y corríjalas antes de que contaminen sus datos, para obtener enriquecimientos reproducibles, comparables y precisos.
Entity Enricher trata los LLM como bases de conocimiento consultables. Eso solo funciona cuando el nombre de una propiedad determina una única respuesta reproducible. Una propiedad como annual_revenue no lo hace: ¿qué año fiscal? ¿Qué moneda? ¿Millones o unidades? Cada modelo —y cada nueva ejecución del mismo modelo— es libre de elegir un marco distinto, por lo que los valores difieren aunque ningún modelo esté equivocado.
Las propiedades volátiles perjudican todo lo que viene después: la fusión multimodelo ve conflictos que en realidad son diferencias de enfoque, y las dispersiones de consistencia del benchmark se amplían por razones que no tienen nada que ver con la calidad del modelo. La comprobación de no determinismo encuentra estas propiedades y le indica cómo fijarlas.
Cada propiedad marcada se clasifica en una de cuatro causas, cada una con su propio remedio:
| Causa | Ejemplo | Solución |
|---|---|---|
| Temporal | ceo, stock_priceceo_2025 | Un dato cambiante sin fecha de referencia: fije el período o reestructúrelo en un array indexado por período. |
| Ambiguo | annual_revenuerevenue_fy2024_usd_millions | El nombre no fija la unidad, la moneda, el período ni el alcance: incorpore el marco que falta en el nombre o la descripción. |
| Subjetivo | reputationesg_risk_rating_sustainalytics | Sin una verdad fundamental objetiva: sustitúyalo por un indicador medible o una escala fija; de lo contrario, seguirá marcado como consultivo. |
| Múltiples valores | top_competitorstop_3_competitors_by_revenue | Varias respuestas igualmente correctas, normalmente una lista sin límite: acótela e indique el criterio de ordenación. |
Cambiar el nombre no es la única solución: para las propiedades del esquema, el analizador también propone una corrección de la descripción que fija el marco que falta. Una descripción más precisa llega a la IA de enriquecimiento igual que el nombre, pero nunca rompe su contrato de datos, por lo que es el remedio preferido para esquemas que ya están en uso.
Una vez generada una muestra, el analizador la revisa. Los cambios de nombre inequívocos se aplican automáticamente a las claves inventadas por la IA (nunca a los campos que usted mismo nombró), y las correcciones estructurales se devuelven al generador durante un máximo de dos rondas de corrección. Las muestras basadas en documentos adjuntos se omiten: sus valores provienen del documento de origen, no del recuerdo del modelo.
Una vez guardado un esquema generado, un paso posterior anota cada propiedad con su nivel de no determinismo. Este paso es de mejor esfuerzo: si falla, la generación en sí no se ve afectada.
El botón de nueva comprobación analiza solo las propiedades que aún no tienen anotación, y cambia a un reanálisis completo una vez que todas las propiedades están anotadas.
El JSON de muestra que pega para crear un esquema puede analizarse sin estado: obtiene un informe de nombres de propiedades arriesgados sin que se modifique nada.
La comprobación es solo consultiva. Nunca bloquea la generación, nunca rechaza un enriquecimiento, y sus anotaciones se eliminan de cada prompt enviado a los modelos de enriquecimiento: le informa a usted, no a la IA.
Las propiedades marcadas muestran una insignia de «varía» en el Editor de esquemas: ámbar para riesgo medio, rojo para riesgo alto. Al pasar el cursor sobre la insignia se muestra la nota del analizador que explica qué varía y por qué. Las propiedades consideradas deterministas no llevan insignia.
Un veredicto se emite sobre el nombre y la descripción de una propiedad en conjunto, de modo que cambiar el nombre de una propiedad o editar su descripción elimina su anotación. El editor resalta esas propiedades como obsoletas y ofrece una nueva verificación, que analiza solo lo que falta. Esto es justo lo que desea después de aplicar un cambio de nombre sugerido: la nueva verificación confirma si el nuevo nombre es determinista.
La comprobación puede desactivarse por esquema desde el menú adicional del Editor de esquemas. Cuando está desactivada, se omite el paso posterior a la generación y se ocultan las insignias, el botón de nueva comprobación y las advertencias de obsolescencia. Las anotaciones existentes se conservan (solo se ocultan), y volver a activar la comprobación en un esquema que nunca se analizó la ejecuta automáticamente.
Los esquemas generados a partir de documentos adjuntos comienzan con la comprobación desactivada: sus valores se transcriben del documento de origen, por lo que la varianza de una ejecución a otra en el conocimiento del modelo no aplica.
Las notas del analizador se escriben en el idioma de su interfaz: un usuario francés ve explicaciones en francés y uno japonés en japonés. Los nombres de propiedad sugeridos permanecen en inglés, conforme a las convenciones de nomenclatura de esquemas.
Cada análisis es una llamada real (económica) al modelo, registrada como su propio prompt en el registro y descontada de los créditos como cualquier otro uso de IA. Las nuevas verificaciones incrementales solo cobran por las propiedades realmente analizadas.
A la propia generación de esquemas se le indica que produzca nombres y descripciones deterministas (períodos, unidades y criterios de ordenación fijados), por lo que la mayoría de los esquemas salen limpios y el analizador solo tiene que detectar los rezagados.
La comprobación está disponible mediante programación:
| Superficial | Descripción |
|---|---|
POST /api/schema/analyze-sample | Analiza el JSON de muestra pegado: informe sin estado, no se modifica nada |
POST /api/schema/saved/{id}/analyze | Analiza un esquema guardado y escribe anotaciones: incremental de forma predeterminada; force=true reanaliza todo |
analyze_sample_determinism | Herramienta MCP: el mismo informe de muestra sin estado desde Claude o cualquier cliente MCP |
analyze_schema_determinism | Herramienta MCP: anota un esquema guardado; combínela con edit_schema para aplicar un cambio de nombre sugerido |
Consulte la Referencia de la API y la guía del servidor MCP para la autenticación y el catálogo completo de herramientas.