Schema Builder
Schema Builder te permite describir qué información quieres obtener y cómo debe estar organizada: un nombre, una descripción y la lista de campos con su tipo. A esa descripción se le llama esquema.
Lo conectas a un componente de extracción, como Trustcall Extractor, para que un modelo de IA sepa exactamente qué datos sacar de un texto.
Cuándo usarlo
- Indicar qué datos sacar de cada factura: proveedor, fecha, importe e impuestos.
- Definir los campos de un contacto (nombre, empresa, teléfono, correo) para extraerlos de firmas de correo.
- Preparar varios esquemas distintos, uno por tipo de documento, y dejar que el extractor elija el adecuado.
- Mantener en un único lugar la definición de los datos que tu equipo extrae una y otra vez.
Configuración
| Campo | Qué hace |
|---|---|
| Model Name | El nombre del esquema, por ejemplo Factura o Contacto. Usa un nombre corto y claro: el modelo de IA lo tiene en cuenta. |
| Model Description | Qué representa el esquema, en una o dos frases. Ayuda al modelo a entender qué buscar. |
| Model Fields | Los campos del esquema. Pulsa Editar Esquema de Argumentos para abrir el editor y usa Agregar Argumento para añadir cada campo. |
En el editor, cada campo tiene estas columnas:
| Columna | Qué indica |
|---|---|
| Name | El nombre del campo, por ejemplo importe_total. |
| Description | Qué contiene el campo. Es obligatoria y es lo que el modelo lee para saber qué buscar. |
| Type | El tipo de valor: string (texto), integer (número entero), number (número con decimales), boolean (sí o no), array (lista), object (grupo de campos) o any (cualquiera). |
| Default | Valor que se usa si no se encuentra el dato. |
| Required | Si el campo debe aparecer siempre. |
El editor tiene dos vistas: Table Schema, para editar los campos en una tabla, y JSON View, para ver o pegar la definición completa.
Resultado
El componente tiene dos salidas:
- Schema: el esquema, listo para conectarlo a la entrada Schemas de Trustcall Extractor.
- JSON: la definición del esquema en formato de datos estructurados, útil para revisarla o pasarla a otro componente.
Ejemplo
El departamento de administración quiere registrar las facturas que llegan por correo. Crea un Schema Builder con Model Name Factura, Model Description “Datos principales de una factura de proveedor” y cuatro campos: proveedor (string), fecha (string), importe_total (number) y numero_factura (string). Conecta Schema a un Trustcall Extractor, que saca esos cuatro datos de cada factura.
Buenas prácticas
- Escribe descripciones concretas en cada campo, por ejemplo “Importe total con impuestos, sin símbolo de moneda”. Cuanto más clara, mejor extrae el modelo.
- Usa un Schema Builder por cada tipo de información que quieras extraer.