Structured Output
Structured Output lee un texto libre (un correo, una nota, una conversación) y, con ayuda de un modelo de IA, saca de él la información que necesitas organizada en campos. Tú defines qué campos quieres y de qué tipo es cada uno; el componente devuelve registros con esos campos rellenos.
Si en el texto aparecen varios elementos que encajan con tu definición, por ejemplo varios productos en un mismo pedido, obtienes un registro por cada uno.
Cuándo usarlo
- Sacar de cada correo de un cliente su nombre, el número de pedido y el motivo de la consulta.
- Convertir la descripción libre de una incidencia en un registro con categoría, prioridad y equipo responsable.
- Extraer todos los productos y cantidades que aparecen en un pedido escrito a mano o por chat.
- Preparar datos ordenados a partir de textos para guardarlos en una hoja de cálculo o un CRM.
Configuración
| Campo | Qué hace |
|---|---|
| Model | El modelo de IA que leerá el texto. Conecta aquí un componente de modelo. |
| Input Message (obligatorio) | El texto del que quieres sacar la información. |
| Schema Name (obligatorio) | Un nombre para lo que vas a extraer, por ejemplo Pedido o Incidencia. Los espacios y símbolos se convierten en _; si lo dejas vacío, se usa StructuredOutput. |
| Output Schema (obligatorio) | Los campos que quieres obtener. Pulsa Editar Esquema de Argumentos y añade cada campo con Agregar Argumento, indicando su nombre, una descripción y su tipo. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Format Instructions (obligatorio) | Las instrucciones que recibe el modelo. Las que vienen por defecto le piden extraer todos los elementos que encajen con los campos, dejar vacíos los valores que no encuentre y quitar los duplicados exactos. Normalmente no necesitas cambiarlas. |
Resultado
La salida llm_structured_output devuelve un registro por cada elemento encontrado en el texto, con los campos que definiste en Output Schema. Puedes conectarla a un Loop, a Parse Data o a un componente que guarde los datos.
Ejemplo
Una distribuidora recibe pedidos por correo escritos de forma libre: “Necesito 20 cajas de agua y 5 de zumo de naranja para el viernes”. Conecta el texto del correo a Input Message, pone Schema Name LineaPedido y define en Output Schema los campos producto (string), cantidad (integer) y fecha_entrega (string). El componente devuelve dos registros, uno por producto, que se añaden a la hoja de pedidos.
Buenas prácticas
- Escribe en cada campo una descripción clara de lo que debe contener. El modelo la usa para decidir qué poner.
- Si un dato puede no aparecer en el texto, cuenta con que ese campo llegue vacío.