Tool use y JSON Schema: salida estructurada y los modos del parámetro tool choice

Bienvenidos y bienvenidas a la cápsula tres del Módulo uno. Seguimos en el dominio cuatro con la primera parte del task statement cuatro punto tres: obtener salida estructurada con tool use y JSON Schema.

Defines una herramienta de extracción cuyo esquema de entrada es justo la estructura que quieres recibir. El modelo la llama, y tú lees los datos desde el bloque tool use de la respuesta. No ejecutas nada: la herramienta existe solo para darle forma a la salida. La guía oficial dice que es la forma más confiable de obtener una salida que cumple el esquema, y que elimina los errores de sintaxis del JSON.

El parámetro tool choice tiene tres modos que el examen pide conocer. Con auto, el modelo puede responder con texto y no llamar ninguna herramienta. Con any, debe llamar alguna herramienta, pero elige cuál. Y con el modo forzado, que indica el nombre de una herramienta, debe llamar exactamente esa.

La decisión que evalúa el examen tiene dos casos. Si tienes varios esquemas, por ejemplo factura, contrato y recibo, y no sabes qué documento llega, usas any: garantizas salida estructurada y el modelo elige el esquema. El nombre de la herramienta que llama te dice qué tipo de documento detectó, y su contenido trae los datos. Por su parte, si una extracción tiene que ocurrir antes que otros pasos, como sacar los metadatos para decidir a qué sistema enviar el documento antes de enriquecerlo, fuerzas esa herramienta por nombre. La opción tentadora y equivocada es dejar auto y pedir en el prompt que responda en JSON. Con auto el modelo puede contestar con texto, y un prompt no es una garantía.

El límite que más pregunta el examen: un esquema estricto elimina los errores de sintaxis, pero no los errores semánticos. La guía da dos ejemplos: las partidas de una factura que no suman el total declarado, y valores puestos en el campo equivocado. El JSON es perfecto y el contenido está mal. Por eso sigue haciendo falta validación semántica, que veremos en la cápsula de validación y reintento.

Una pregunta. Si el JSON es válido, ¿está bien la información?

No necesariamente. Válido significa que respeta la forma, y el significado hay que validarlo aparte.

Pregunta uno. Una concesionaria de autopistas extrae los montos de peaje de documentos de cobro, y a veces el modelo responde con texto libre en vez del JSON que espera el sistema. ¿Qué cambio conviene? Opción A: aplicar una expresión regular sobre el texto de la respuesta para rescatar los montos. Opción B: definir una herramienta de extracción con esquema JSON y forzar su uso con tool choice. Opción C: reintentar la llamada hasta que salga bien. Opción D: pedir en el prompt que siempre responda en JSON, con tool choice en automático.

La correcta es B. Con una herramienta y su esquema, la respuesta llega en un bloque estructurado, y el modo forzado evita que el modelo conteste con texto. La A parchea el síntoma. La C no cambia la causa. La D depende de una petición, y con tool choice en automático el modelo puede seguir escribiendo texto.

Pregunta dos, de respuesta múltiple. Elige dos. Una empresa forestal extrae datos de guías de despacho. El JSON siempre es válido, pero algunos valores quedan en el campo equivocado y otros no cuadran con el total de la guía. ¿Qué dos ideas son correctas? Opción A: como el JSON valida contra el esquema, la extracción es correcta. Opción B: agregar una validación que compare el total declarado con la suma de las partidas. Opción C: quitar del esquema los campos que dan problemas. Opción D: pedir la misma extracción varias veces. Opción E: un esquema válido evita errores de sintaxis, pero no errores de semántica. ¿Cuáles dos?

Las correctas son B y E. La A confunde forma con contenido. La B detecta los totales que no cuadran. La C borra información útil. La D repite el mismo error. La E separa lo que el esquema garantiza, la forma, de lo que no, el significado.

Resumen: tool use con un esquema es la salida estructurada más confiable. Usas any cuando el tipo de documento es desconocido, y el modo forzado cuando el orden importa. Y el esquema garantiza la forma, no el significado. Si te sirvió, sigue el podcast, dale cinco estrellas y activa las notificaciones. En la próxima cápsula vemos el diseño de esquemas, con campos nullable y enums con other. Nos escuchamos en la próxima cápsula de EvoAcademy.