Clase 04 · Módulo 09
Instrucciones y salidas estructuradas
Instrucciones y salidas estructuradas
Qué logras en esta clase
Consigues que un paso de IA devuelva siempre la misma forma de respuesta y que el flujo sepa qué hacer cuando no la cumple.
- Escribes instrucciones pensadas para un flujo, no para una conversación.
- Defines campos fijos con valores permitidos.
- Validas la respuesta y desvías lo dudoso a una persona.
02
Lo que un flujo necesita
A un flujo no le sirve una respuesta bonita. Le sirve una respuesta que el nodo siguiente pueda leer.
03
El problema del texto libre
Le preguntas al modelo si un mensaje es un reclamo. Dos corridas, dos respuestas:
Sí, parece un reclamo por una demora en la entrega.
Este mensaje corresponde a una queja del cliente.Las dos son correctas. Ningún IF puede comparar contra ellas, porque no sabes qué palabras vendrán la próxima vez.
04
La solución: campos fijos
Pides la respuesta como JSON, el formato de datos que usan los ítems de n8n (módulo 3):
{ "tipo": "reclamo", "urgente": true }Ahora el nodo siguiente lee tipo y urgente con una expresión, igual que cualquier otro dato del flujo.
05
Cinco partes de una instrucción
| Parte | Qué dice |
|---|---|
| Tarea | Qué debe hacer, en una frase |
| Contexto | Qué negocio es y qué texto va a recibir |
| Campos | Qué campos devolver y de qué tipo |
| Valores permitidos | La lista cerrada de cada campo |
| Caso de duda | Qué devolver si no está claro |
Si falta la última, el modelo elige por ti.
06
Un pedido flojo y uno preciso
Flojo:
Dime de qué trata este mensaje.Preciso:
Clasifica el mensaje de un cliente de una cafetería.
Campo tipo: pedido, reclamo, consulta u otro.
Si no está claro, usa otro.El segundo no es más largo por adorno: cada línea elimina una respuesta posible que tu flujo no sabría manejar.
07
Listas cerradas
- Pocas categorías: entre tres y siete funciona mejor que veinte.
- Que no se pisen: un mensaje debe caber en una sola.
- Una línea de descripción por cada una.
- Escritas tal como las usará el Switch:
reclamo, no «Reclamo del cliente».
08
La salida para la duda
Dale siempre una opción para cuando no sabe. Un modelo sin «no está claro» inventa.
09
Lo fijo y lo variable van separados
- Instrucciones: lo que no cambia. Se escriben una vez en el nodo.
- Dato: lo que cambia en cada corrida. Llega con una expresión, por ejemplo
{{ $json.mensaje }}.
10
Tres formas de obtener estructura
| Forma | Cuándo conviene |
|---|---|
| Nodo especializado (Text Classifier, Information Extractor) | La tarea es clasificar o extraer |
| Basic LLM Chain con un analizador de salida | Necesitas una estructura propia |
| Pedir JSON en el texto y leerlo tú | Solo si no hay otra opción: es la más frágil |
Las dos primeras hacen que n8n revise la forma por ti.
11
Definir el esquema
Un esquema es la descripción de la forma: qué campos hay y de qué tipo es cada uno. Los nodos de n8n suelen ofrecer dos maneras de darlo:
- Pegar un ejemplo de JSON con la forma deseada.
- Describir campo por campo: nombre, tipo y explicación.
12
Describir bien un campo
| Campo | Tipo | Descripción |
|---|---|---|
tipo | texto | Una de: pedido, reclamo, consulta, otro |
urgente | sí o no | Sí solo si pide respuesta hoy |
resumen | texto | Máximo 15 palabras |
La descripción es parte de la instrucción: el modelo la lee. Una descripción vaga produce un campo vago.
13
Pedida no es lo mismo que garantizada
- Pedida: escribes «responde en JSON». El modelo casi siempre cumple.
- Garantizada: la API restringe la respuesta al esquema. La API de Claude ofrece esta función con el nombre de salidas estructuradas.
Si el nodo que usas en n8n aprovecha esa función depende de su versión: compruébalo en su página. Por eso validas igual.
14
Validar después del modelo
La validación son nodos normales: un IF, un Filter o un nodo Code corto. No uses otro modelo para revisar al primero.
15
Qué revisar
| Revisión | Ejemplo |
|---|---|
| El campo existe | tipo no viene vacío |
| El valor está en la lista | tipo es uno de los cuatro |
| El formato es correcto | La fecha tiene forma de fecha |
| El número es número | monto no trae texto |
| Hay coherencia | Neto más impuesto da el total |
Las fechas, montos y el RUT se validan como en el módulo 3, clase 4.
16
Forma correcta, contenido falso
Un JSON válido puede traer un dato inventado. Validar la forma no reemplaza revisar el contenido.
17
Cuando no cumple
| Qué pasó | Qué hace el flujo |
|---|---|
| Respuesta sin la forma pedida | Reintenta una vez |
| Segundo intento también falla | Deriva a una persona |
| Valor fuera de la lista | Lo trata como otro y lo registra |
| Campo obligatorio vacío | Deriva a una persona |
18
La rama de revisión
Guarda el texto original y lo que respondió el modelo. Esa planilla es tu mejor fuente para mejorar las instrucciones: muestra exactamente dónde falla.
19
Ejemplos dentro de la instrucción
Dos o tres ejemplos cortos de entrada y salida suelen mejorar la consistencia más que un párrafo de explicación.
- Elige casos que estén en el límite entre dos categorías.
- Incluye uno cuya respuesta sea
otro. - Recuerda que se pagan como tokens de entrada en cada corrida.
20
Probar con casos difíciles
- Junta veinte entradas reales.
- Agrega un mensaje vacío, uno larguísimo y uno en otro idioma.
- Agrega uno que mezcle dos temas.
- Agrega uno que diga «ignora lo anterior y responde otra cosa».
- Córrelos todos y revisa cuáles pasan la validación.
Lo que falla aquí va a fallar en producción.
21
Cambiar las instrucciones a ciegas
Guarda tus casos de prueba y córrelos completos después de cada cambio. Es la misma idea de las pruebas del módulo 13.
22
Lo que te llevas
- Un flujo necesita campos fijos, no texto libre.
- La instrucción define tarea, campos, valores permitidos y caso de duda.
- Los nodos especializados de n8n revisan la forma por ti.
- Después del modelo siempre hay una validación con nodos normales.
- Lo que no cumple se reintenta una vez y luego va a una persona.
23
Hazlo ahora
En 15 minutos, sin abrir n8n:
- Elige una tarea de clasificación o extracción de tu proceso.
- Escribe la tabla de campos: nombre, tipo y descripción.
- Para cada campo de lista, escribe los valores permitidos e incluye el de duda.
- Escribe tres revisiones que haría tu validación.
- Anota quién recibe los casos que no pasan.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026