# JSON schema

> Una descripción formal de la forma de un documento JSON — claves, tipos, campos requeridos, valores permitidos — usada para acotar y validar la salida del modelo.

Fuente: Promptea — https://www.promptea.me/es/glossary/json-schema · Idioma: Español · Última actualización: 2026-11-09

## Qué significa

- Definición: JSON Schema es un vocabulario estándar para describir JSON: qué claves existen, sus tipos, cuáles son obligatorias, enumeraciones, mínimos y patrones.
- Por qué importa: es el contrato entre el modelo y tu código. Incluso un esquema simplificado pegado en el prompt (claves y tipos) hace la salida mucho más consistente.
- Cómo aplicarlo: en el prompt, dá el esquema, pedí 'devolvé SOLO JSON' y decí qué hacer con valores faltantes (null, no una suposición). Donde el proveedor ofrece salidas estructuradas, pasá el esquema ahí para que el formato se imponga al generar.
- En producción, validá siempre el resultado contra el esquema y reintentá o rechazá si falla; no asumas que un JSON válido tiene contenido correcto.

## Ejemplo

```text
Extraé el pedido del texto. Devolvé SOLO JSON que cumpla este esquema:
{"orderId":"string","items":[{"sku":"string","qty":"number"}],"notes":"string|null"}
Si falta un campo en el texto, usá null. No adivines.

Texto:
"""[pegá]"""
```

[Abrir en Promptea](https://www.promptea.me/es/analyzer?prompt=Extra%C3%A9+el+pedido+del+texto.+Devolv%C3%A9+SOLO+JSON+que+cumpla+este+esquema%3A%0A%7B%22orderId%22%3A%22string%22%2C%22items%22%3A%5B%7B%22sku%22%3A%22string%22%2C%22qty%22%3A%22number%22%7D%5D%2C%22notes%22%3A%22string%7Cnull%22%7D%0ASi+falta+un+campo+en+el+texto%2C+us%C3%A1+null.+No+adivines.%0A%0ATexto%3A%0A%22%22%22%5Bpeg%C3%A1%5D%22%22%22&purpose=data&target=gpt)

## Preguntas frecuentes

### ¿Alcanza con el esquema en el prompt para garantizar JSON válido?

Lo hace probable, no seguro. Para tener garantías usá la función de salida estructurada del proveedor cuando exista y validá el resultado en tu código.

### ¿Conviene pedir bloques de código markdown alrededor del JSON?

No si lo lee un programa: pedí 'devolvé SOLO JSON, sin markdown' para poder parsearlo directamente.

## Relacionado

- [Cómo forzar salida JSON válida (sin markdown)](https://www.promptea.me/es/guides/json-output)
- [Prompts para output estructurado: cómo obtener JSON, tablas y listas confiables de cualquier IA](https://www.promptea.me/es/guides/structured-output-prompting)
- [Few-shot prompting: cómo mostrar ejemplos en vez de solo explicar](https://www.promptea.me/es/guides/few-shot-prompting)
- [Salida estructurada](https://www.promptea.me/es/glossary/structured-output)
- [Few-shot prompting](https://www.promptea.me/es/glossary/few-shot)