Cómo escribir un prompt que pide salida estructurada

Describe la forma exacta que quieres, no solo el nombre del formato

Decir "devuelve esto como JSON" es un comienzo, pero nombrar los campos, su orden y sus tipos es lo que realmente elimina la ambigüedad: "devuelve un objeto JSON con un campo de texto llamado title y un campo de array llamado steps, donde cada paso es un texto" deja mucho menos por adivinar al modelo que "devuelve JSON con el title y los steps". Lo mismo aplica a una tabla: nombra las columnas y qué pertenece a cada una en lugar de asumir que el modelo elegirá el mismo desglose que tienes en mente.

Muestra un ejemplo de la salida exacta que quieres

Un solo ejemplo de la forma terminada, un objeto JSON de muestra breve, o una fila de la tabla, a menudo elimina más ambigüedad que otro párrafo de descripción, por la misma razón por la que un ejemplo ayuda en el prompting con pocos ejemplos, enlazado más abajo. Esto importa más cuando el formato tiene una peculiaridad fácil de describir de forma imprecisa, como si un campo es opcional o cómo debe representarse un valor ausente.

Lo que un prompt bien escrito no garantiza aquí

Un prompt escrito con cuidado hace más probable una salida válida y bien formada, pero no lo garantiza: un modelo puede devolver JSON malformado, un campo extra, o prosa envolviendo la estructura que pediste, especialmente en una respuesta más larga o compleja. Consulta qué son las salidas de IA estructuradas, enlazado más abajo, para conocer los mecanismos técnicos, como la generación restringida por esquema, que existen precisamente porque el prompting por sí solo no es una garantía fiable, y para saber qué hace ClawAI de forma distinta a simplemente pedirlo con amabilidad en un prompt.

Preguntas frecuentes

¿Basta con pedirlo con amabilidad en un prompt para garantizar un JSON válido?

No: un prompt bien escrito lo hace más probable, no seguro. Consulta qué son las salidas de IA estructuradas, enlazado más abajo, para conocer los mecanismos que existen porque el prompting por sí solo no garantiza de forma fiable una estructura válida.

¿Debería describir el formato o mostrar un ejemplo?

Ambas cosas, cuando el formato tiene cualquier ambigüedad: una descripción precisa de los campos más un ejemplo de la forma terminada cubre más casos que cualquiera de las dos por separado. Consulta prompting con pocos ejemplos, enlazado más abajo, para saber cómo elegir un buen ejemplo.

¿Cuál es la diferencia entre esta guía y qué son las salidas de IA estructuradas?

Esa página explica el mecanismo técnico detrás de una salida estructurada fiable; esta página es la compañera práctica: cómo escribir el prompt en sí. Están pensadas para leerse juntas, no como duplicados una de la otra.