Inicio / Técnicas que cambian el resultado
Salidas estructuradas y salvaguardas
Imponer un esquema exacto a una salida y verificar esa salida antes de usarla son dos mitades del mismo reflejo, una fuerza la forma en origen, la otra la controla en destino, y ambas cuentan más cuando la acción que sigue no tiene marcha atrás.
Las salidas estructuradas obligan a la respuesta de Claude a seguir un esquema preciso, lo que garantiza una salida válida y explotable por un procesamiento automático posterior. Se combinan dos mecanismos distintos: forzar el formato de una respuesta según un esquema definido por un lado, forzar los argumentos de una llamada a herramienta por el otro. Ambos imponen la forma antes de que la respuesta parta, no dicen nada de lo que ocurre después de que llega.
El esquema fuerza la forma, no el contenido
Definir un esquema equivale a dibujar una plantilla: estos campos, estos tipos, este orden, nada más. Un campo nombre espera una cadena, un campo importe espera un número, una respuesta que no encaja con esa plantilla se rechaza incluso antes de llegar al programa que la usa.
schema attendu : { "nom": string, "quantite": number, "urgent": boolean }
sortie recue : { "nom": "gants de protection", "quantite": 12, "urgent": true }
El esquema garantiza que la forma anterior llegue cada vez, no garantiza que doce sea la cifra correcta. El número de campos válidos no dice nada sobre la exactitud de uno solo de ellos: es exactamente lo que un esquema no puede ver.
La salvaguarda verifica lo que el esquema no ve
El segundo reflejo toma el relevo donde se detiene el primero: releer la salida una vez recibida, antes de transmitirla a la siguiente etapa. Una salvaguarda puede ser una regla simple, este importe se mantiene bajo un tope, esta cantidad se mantiene positiva, o un segundo pase que compara la salida con la petición original. En ambos casos, la salida estructurada pasa por una segunda puerta antes de actuar, no se conforma con tener la forma correcta.
Esta segunda puerta cuenta más cuando la acción que sigue no tiene marcha atrás: enviar un mensaje, validar un pedido, modificar un archivo compartido. Una salida mal formada que se queda mostrada en pantalla se corrige de un vistazo, una salida mal formada que desencadena una acción ya ejecutada ya no se corrige. Esta salvaguarda se une a la tesis ya planteada en un verde no prueba nada mientras no haya sido probado él mismo: un control que nunca ha sido puesto en falta por una salida falsa todavía no ha demostrado nada.
Una salida libre contra una salida forzada y luego releída
Sin duda haría falta una docena de guantes de protección, y creo que es bastante urgente.
{ "nom": "gants de protection", "quantite": 12, "urgent": true } -> quantite > 0 : verifieUn almacenero pide a Claude leer un pedido en papel fotografiado y devolver el nombre del artículo, la cantidad y un indicador de urgencia según un esquema fijado de antemano. La respuesta obtenida respeta los tres campos y sus tipos, con la cantidad doce y el indicador de urgencia en verdadero.
Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.
Lo que esto establece: La respuesta respeta el esquema pedido, tres campos presentes, cada uno del tipo esperado, lo que la hace explotable tal cual por un programa posterior.
Lo que esto no establece: No establece que la cantidad doce corresponda realmente a lo escrito en el pedido fotografiado, un esquema respetado no garantiza un contenido exacto.
Los tres calibrados falsos más frecuentes
- Demasiado amplio Puesto que se respeta el esquema, Claude leyó correctamente cada cifra presente en el pedido fotografiado.
- Demasiado estrecho Al haberse tratado un solo pedido, esta respuesta no permite decir nada sobre el esquema en sí.
- Fuera de tema Esta respuesta muestra que la fotografía del pedido era lo bastante nítida para transmitirse a Claude.
- Un esquema de salida garantiza la forma de una respuesta, nunca la exactitud de su contenido, ambas cosas se verifican por separado.
- La salvaguarda interviene después de la respuesta, no antes: relee lo que acaba de llegar en lugar de impedir que una mala forma salga.
- Una acción sin marcha atrás merece una salvaguarda más estricta que una salida simplemente mostrada en pantalla.
- Forzar la forma y verificar el contenido son dos etapas distintas del mismo flujo, no dos formas diferentes de hacer lo mismo.
Elige una tarea donde le pidas regularmente una lista o un importe a Claude, escribe los tres campos exactos que debe contener la respuesta, y añade una frase de regla que tú mismo aplicarás antes de usar esa respuesta.
Estos puntos dependen de una interfaz o de una regla que puede haber cambiado desde la redacción. Verifícalos en tu propia pantalla antes de fiarte de ellos.
- La lista de modelos que admiten las salidas estructuradas evoluciona: abre la página de las salidas estructuradas en tu pantalla y verifica que el modelo que usas figura ahí antes de construir un esquema sobre eso.
Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.
- Anthropic, Structured outputs consultée le 2026-09-02