Editor de flujos de trabajo - Documentación de Entity Enricher

Editor de flujos de trabajo

La página donde se construye un enriquecimiento de principio a fin: datos de muestra, esquema, modelos y resultados. En su centro está el árbol del esquema: un editor visual con reordenación mediante arrastrar y soltar, edición en línea, navegación por teclado y modificaciones asistidas por IA.

Resumen

El árbol de esquema le permite ver y modificar sus esquemas de enriquecimiento sin escribir JSON a mano. Las propiedades se muestran como un árbol interactivo agrupado por dominio de especialidad, de modo que pueda ver de un vistazo qué campos pertenecen a cada área especializada. Cada cambio queda registrado con un historial de deshacer/rehacer y se guarda automáticamente tras 2 segundos de inactividad.

Capacidades clave

Agrupación por expertise

Propiedades agrupadas por dominio de experiencia con secciones plegables. Active o desactive la agrupación.

Arrastrar y soltar

Con la vista Ordenada desactivada, reordene las propiedades dentro de un grupo o entre grupos arrastrándolas — la disposición se guarda en el esquema. Los indicadores visuales de destino muestran dónde se colocarán los elementos.

Edición en línea

Haga clic en cualquier propiedad para editar su nombre, tipo, descripción y ejemplos directamente en el árbol.

Navegación con teclado

Flechas para navegar y para contraer o expandir, Enter para editar, Supr para eliminar, Ctrl+A para seleccionar todo. Deshacer y rehacer son botones de la barra de herramientas, y el historial se conserva al cambiar de esquema o recargar la página.

Buscar y filtrar

Búsqueda de texto para encontrar campos en esquemas grandes: primero los nombres de las propiedades, recurriendo a las descripciones y los ejemplos cuando ningún nombre coincide. Las coincidencias anidadas se muestran solo con la ruta que conduce a ellas.

Deshacer / Rehacer

Pila de historial completa para ediciones manuales. Los cambios generados por IA reemplazan sin agregar entradas para deshacer.

Tipos y conjuntos de valores

Las pestañas de la parte superior contienen los tipos con nombre del esquema. El botón + crea un Objeto (una entidad anidada con sus propias propiedades) o un Enum (una lista cerrada de valores permitidos a la que puede apuntar cualquier propiedad de texto).

Vista de diagrama

La vista DIAGRAMA, junto a ESQUEMA y JSON, representa el esquema como un diagrama de entidades: las entidades con nombre aparecen como tarjetas con título y los objetos anidados como tarjetas simples identificadas por su relación, con las referencias (1–1) y los enlaces (1–N) como líneas discontinuas. Se actualiza en tiempo real a medida que edita y, al hacer clic en la tarjeta de una entidad, esta se abre en la vista ESQUEMA.

El árbol de propiedades

Cada fila del editor representa una propiedad del schema con sus atributos clave visibles de un vistazo:

SelNombre de la propiedadTipoDescripción
□company_name
🔍
stringRazón social de la empresa
□revenuenumberIngresos anuales en USD
□headquartersobjectSede corporativa
□ citystringNombre del municipio
□ country
🔍
stringPaís donde se ubica la sede central
□gmp_statusbooleanEstado de la certificación GMP

Las propiedades anidadas (como city dentro de headquarters) se sangran para mostrar la jerarquía. El icono de lupa marca las claves de búsqueda: campos usados para identificar la entity.

Conjuntos de valores (enumeraciones)

Un conjunto de valores restringe una propiedad de texto a una lista fija de valores permitidos: un estado, una calificación, un código de clasificación. Así, el enriquecimiento no puede devolver nada fuera de esa lista, lo que evita que un mismo concepto llegue con tres grafías distintas entre ejecuciones.

Trabajar con conjuntos de valores

Cree uno

Pulse + en las pestañas de tipos, elija Enum y asígnele un nombre. La nueva pestaña abre su lista de miembros.

Editar miembros

Añada, renombre, reordene o elimine valores. Añada una nota a un miembro cuando su significado no sea evidente por su nombre.

Usarlo

Establezca el Tipo de cualquier propiedad de texto en el conjunto de valores (o en un array del mismo) desde el grupo Conjuntos de valores del menú desplegable de tipos.

Deshacer

Vuelva a establecer el Tipo de la propiedad en string, o elimine el conjunto de valores: las propiedades que lo usan vuelven a ser propiedades de texto normales.

Use un conjunto de valores solo para un vocabulario que pueda enumerar por completo. Si una entidad real necesita un valor que omitió, el modelo se ve obligado a elegir el más parecido, aunque sea incorrecto, en lugar de informar del problema; por eso un campo abierto (un nombre, una descripción, una categoría de texto libre) debe seguir siendo texto sin formato. La generación de esquemas propone conjuntos de valores de forma conservadora por la misma razón, y todo lo que propone se puede editar aquí.

Edición de propiedades

Haga clic en una fila de propiedad o pulse Intro para cambiar al modo de edición. En el modo de edición, puede modificar:

NombreLa clave de la propiedad en la salida JSON. Use snake_case para mantener la coherencia.
TipoElija entre string, number, integer, boolean, array u object. Cambiar el tipo actualiza el formato de salida del enriquecimiento.
DescripciónDescripción contextual que guía a la IA durante el enrichment. Cuanto más detalle, mejores resultados.
EjemplosDos o tres valores de ejemplo realistas. Ayudan a la IA a comprender el formato y el contenido esperados.
EspecializaciónQué experto de dominio proporciona este valor. Determina la agrupación en el enriquecimiento de múltiples dominios de experiencia.
NullableIndica si una instancia real puede carecer realmente de este valor. Los campos que no admiten valores nulos son obligatorios para la admisión en la base de datos: un enriquecimiento que no puede rellenarlos es rechazado por el control de calidad. No está disponible en una clave de base de datos (un valor nulo no identifica ninguna fila) ni en un campo conservado (su entrada siempre lo proporciona).
MultilingüeSi el campo debe enriquecerse en varios idiomas.
ConservarIndica si se debe mantener el valor de entrada original sin cambios. Para valores que pertenecen a su propio sistema —un id de base de datos, un SKU interno, una referencia de cliente—, no para identificadores públicos (CAS, ISBN, EAN, un ticker) que el enrichment puede buscar por usted. En tal caso, cada enrichment debe proporcionar un valor para él.

Atajos de teclado

El editor de esquemas admite un flujo de trabajo totalmente controlado por teclado para una edición eficiente:

AtajoAcción
Arrow Up / DownNavegue entre propiedades (mantenga Shift para ampliar la selección)
Arrow Left / RightContraer o expandir el objeto seleccionado
Home / EndIr a la primera o a la última propiedad
EnterAlternar el modo de edición en la propiedad seleccionada
Delete / BackspaceEliminar la propiedad seleccionada
Ctrl+A / Cmd+ASeleccionar todas las propiedades
EscapeSalir del modo de edición o borrar la selección

Reordenación mediante arrastrar y soltar

Para reordenar a mano hay que desactivar el conmutador Ordenado. El editor lista las propiedades alfabéticamente de forma predeterminada y allí el arrastre está deshabilitado — un orden hecho a mano que un ajuste de visualización pudiera anular en silencio no valdría de mucho. Al desmarcar Ordenado se pasa a la disposición propia del esquema y se habilita el arrastre; una línea de inserción visual muestra exactamente dónde quedará la propiedad, y el orden resultante se guarda con el esquema. Puede arrastrar dentro de un grupo de especialidad o entre grupos para cambiar la asignación de dominio.

Cuando la agrupación por expertise domain está habilitada, arrastrar una propiedad a un grupo diferente actualiza automáticamente su asignación de expertise domain. Esto hace que reorganizar schemas grandes sea intuitivo: basta con arrastrar un campo de «Analista financiero» a «Experto regulatorio» y su expertise domain se actualiza en consecuencia.

Panel de edición con IA

Debajo del árbol de propiedades, el panel de edición con IA le permite modificar el esquema mediante lenguaje natural. Escriba una instrucción como «añade una referencia parent_company» y la IA aplica el cambio conservando su estructura existente.

Sugerencias de IA

Tras cada generación o edición, la IA ofrece 5 sugerencias de mejora que se muestran como chips en los que puede hacer clic. Haga clic en una sugerencia para rellenar automáticamente el campo de edición y aplicarla. Las sugerencias abarcan la integridad de los datos, la calidad, las relaciones, la internacionalización y mejoras específicas del dominio.

Obtenga más información sobre la edición de esquemas con IA en la guía Generación de esquemas con IA.

Insignias de ambigüedad

Lea el nombre de una propiedad en el contexto de su objeto padre: ¿cuántas cosas distintas podría estar pidiendo? Exactamente una es clara. Con dos o más, la propiedad recibe una insignia de ambigua: ámbar cuando las lecturas coinciden casi por completo y solo difieren en casos límite, roja cuando darían lugar a datos sustancialmente distintos. Pase el cursor sobre la insignia para leer las interpretaciones en conflicto que admite el nombre y la descripción reescrita que fija exactamente una de ellas. También se marca un nombre al que el padre no tiene nada que responder: ahí el tooltip enumera las lecturas que se consideraron y se descartaron, y la corrección es un cambio de nombre o una eliminación; ninguna descripción puede dar a una entidad una propiedad que no tiene.

Botón de nueva comprobación

El icono de escudo en la barra de herramientas analiza las propiedades que aún no tienen anotación, y cambia a un reanálisis completo una vez que todo está anotado. Cada ejecución es una pequeña llamada de IA facturada.

Aquí la solución es una descripción

En un esquema guardado, la insignia sugiere una descripción reescrita, nunca un cambio de nombre: el esquema está en producción, así que fijar el significado en la descripción deja intacto el contrato de datos. Una descripción que se limita a repetir el nombre no aporta nada, y la propiedad se evalúa como si no tuviera ninguna.

Anotaciones obsoletas

Renombrar una propiedad o editar su descripción elimina su anotación, ya que el veredicto se emitió sobre ambas. El editor resalta estas propiedades y ofrece una nueva comprobación.

Interruptor por esquema

Desactive la verificación de un esquema desde el menú de opciones adicionales: las insignias y advertencias desaparecen, y al reactivarla en un esquema nunca analizado, la verificación se ejecuta automáticamente.

Toda la mecánica —los dos veredictos, las interpretaciones detrás de cada uno y por qué la solución es un cambio de nombre antes de que exista el esquema, pero una descripción cuando ya está activo— se explica en la guía Verificación de ambigüedad.

Gestión de esquemas

El selector de esquemas le permite crear, cargar, fijar, duplicar y eliminar esquemas. Los esquemas se guardan por organización y están accesibles para todos los miembros del equipo.

Guardado automático

Los cambios se guardan automáticamente tras una pausa de 2 segundos, con deduplicación por hash de contenido para evitar escrituras innecesarias.

Fijar esquemas

Fije los esquemas de uso frecuente para mantenerlos en la parte superior de la lista del selector.

Duplicar

Cree una copia de cualquier esquema para experimentar con cambios sin afectar al original.

Eliminación lógica

Los esquemas eliminados se pueden restaurar. La eliminación permanente es una acción independiente.

Próximos pasos