Anatomía de un prompt de trabajo
Un encargo bien hecho en el chat suele bastar para una tarea puntual. Pero cuando un prompt se va a usar muchas veces, conviene construirlo con más cuidado, como se arma un formato de la oficina: cada sección en su lugar, fácil de revisar y de modificar sin romper lo demás.
En esta lección vas a desarmar un prompt de trabajo en seis piezas y ver en qué orden conviene ponerlas. No es una fórmula rígida: lo importante es saber cuál falta cuando algo sale mal.
Al terminar podrás:
- reconocer las seis piezas de un prompt de trabajo y para qué sirve cada una;
- ordenarlas según el tamaño de los materiales;
- escribir criterios de calidad que la IA pueda revisar antes de entregarte;
- reorganizar un prompt desordenado para que sea fácil de mantener.
Las seis piezas
| Pieza | Pregunta que responde | Error típico si falta |
|---|---|---|
| Objetivo | ¿Para qué sirve el resultado? | Respuesta correcta pero inútil para el fin real |
| Contexto | ¿Quién eres, quién lo recibe, qué hay que saber? | Respuesta genérica |
| Materiales | ¿Con qué información debe trabajar? | Datos inventados o supuestos |
| Instrucciones | ¿Qué debe hacer, paso por paso, y qué reglas sigue? | Hace otra cosa o se salta pasos |
| Formato | ¿Cómo debe verse la entrega? | Longitud, estructura o tono incómodos |
| Criterios de calidad | ¿Cómo sabes que quedó bien? | Errores que nadie revisó |
Veamos cada una con más detalle.
Objetivo. Una o dos frases sobre la finalidad, no solo la tarea. "Redacta la descripción de un departamento" es la tarea. "Queremos que la gente interesada pida una visita, y que quien no puede pagarlo no nos escriba" es el objetivo. Con el objetivo, la IA toma mejores decisiones sobre qué destacar.
Contexto. Lo que una persona nueva necesitaría saber: tu empresa, el público, la situación, las restricciones del negocio. Explica también el porqué de las reglas importantes. Los modelos actuales generalizan mejor cuando entienden la razón: "no menciones el precio por metro cuadrado, porque en esta zona espanta a los compradores primerizos" funciona mejor que "no menciones el precio por metro cuadrado".
Materiales. Los datos con los que debe trabajar: el correo del cliente, la ficha técnica, el reporte, la lista de productos. Es lo que cambia cada vez que usas el prompt. En la lección 1.3 verás cómo separarlos con etiquetas para que no se mezclen con tus instrucciones.
Instrucciones. Lo que debe hacer, en orden si hay varios pasos. Usa verbos concretos y numera cuando el orden importe. Incluye aquí las reglas: qué no inventar, qué hacer si falta información, qué temas evitar.
Formato. Cómo debe verse el producto terminado: extensión, estructura, secciones, trato, idioma. Mientras más precisa sea esta pieza, menos edición haces después. Lo verás a fondo en la lección 2.1.
Criterios de calidad. Una lista corta de condiciones que el resultado debe cumplir, escrita de forma que se pueda comprobar. Sirve para dos cosas: le pides a la IA que revise su respuesta contra esa lista antes de entregar, y tú la usas para revisar. En el módulo 4 esta pieza se convierte en tu rúbrica de evaluación.
El orden importa
Las piezas pueden ir en distinto orden, pero hay dos acomodos que funcionan bien en la práctica.
Materiales cortos (un correo, una ficha de media página): objetivo y contexto primero, luego materiales, luego instrucciones, formato y criterios. Se lee como un encargo natural: primero entiendes la situación, luego ves el material, luego sabes qué hacer con él.
Materiales largos (un contrato, un reporte de 30 páginas, varios documentos): materiales primero, y al final el objetivo, las instrucciones, el formato y los criterios. La documentación de Anthropic para Claude recomienda poner los documentos largos arriba y la pregunta al final, y reporta mejoras de calidad de hasta 30 por ciento en sus pruebas con entradas complejas. Lo verás en detalle en la lección 3.1.
En ambos casos hay una regla que no cambia: las instrucciones de formato y los criterios de calidad van cerca del final, que es lo último que la IA lee antes de responder.
Ejemplo resuelto: descripciones para portales inmobiliarios
Rodrigo trabaja en una inmobiliaria pequeña en Querétaro. Cada semana publica entre cinco y diez propiedades en portales y en Facebook Marketplace. Antes pedía: "Hazme una descripción atractiva de este departamento" y pegaba los datos. Las descripciones salían llenas de frases como "un oasis de tranquilidad" y a veces mencionaban amenidades que el edificio no tenía.
Así quedó su prompt armado con las seis piezas:
<objetivo>
Escribir la descripción de una propiedad en renta o venta para portales
inmobiliarios. Queremos que las personas interesadas pidan una visita y que
quien busca otra cosa (otro presupuesto, otra zona) lo note rápido y no
escriba.
</objetivo>
<contexto>
Somos Casa Bernal Inmuebles, una inmobiliaria de Querétaro. Nuestros
clientes suelen ser familias jóvenes y personas que se mudan por trabajo
al corredor industrial. Valoran datos concretos: tiempos de traslado,
seguridad, estacionamiento, escuelas cercanas. Las frases exageradas les
generan desconfianza, porque muchos ya visitaron propiedades que no se
parecían a su anuncio.
</contexto>
<ficha_tecnica>
[pegar aquí la ficha de la propiedad]
</ficha_tecnica>
<instrucciones>
1. Lee la ficha técnica y usa solo los datos que aparecen en ella.
2. Empieza con lo que más le importa a quien busca en esta zona: tipo de
propiedad, colonia, precio y una ventaja concreta.
3. Describe los espacios y amenidades en el orden en que se recorre la
propiedad.
4. Si la ficha no indica un dato importante (estacionamiento, mascotas,
mantenimiento), no lo supongas: agrégalo a la lista de datos faltantes.
</instrucciones>
<formato>
- Título de máximo 70 caracteres.
- Descripción de 120 a 150 palabras, en párrafos cortos, trato de usted.
- Al final, una línea: "Datos faltantes:" seguida de la lista, o
"ninguno".
</formato>
<criterios_de_calidad>
Antes de entregar, revisa que:
- cada dato de la descripción aparece en la ficha técnica;
- no hay adjetivos vagos como "espectacular", "de ensueño" u "oasis";
- el precio y la colonia aparecen en las dos primeras líneas;
- la extensión está dentro del rango pedido.
</criterios_de_calidad>
Algunas decisiones que vale la pena notar:
- El objetivo incluye a quién no queremos atraer. Eso cambia la descripción: el precio sube a la primera línea.
- El contexto explica por qué evitar las exageraciones. Así la IA entiende que el problema es la confianza, no solo unas palabras sueltas.
- La instrucción 4 y la línea de "Datos faltantes" convierten un riesgo (inventar amenidades) en algo útil: una lista de lo que debe preguntarle al propietario.
- Los criterios de calidad se pueden comprobar con un sí o un no.
Cómo escribir criterios de calidad que sirvan
Los criterios son la pieza más olvidada y la que más ayuda cuando un prompt se repite. Algunas pautas:
- Que se puedan verificar. "Que sea claro" no se puede comprobar; "que no tenga párrafos de más de tres líneas" sí.
- Pocos y concretos. De tres a cinco criterios. Si escribes quince, ninguno pesa.
- Basados en errores reales. Cada vez que la IA te entregue algo que tuviste que corregir, pregúntate si ese error merece un criterio.
- Dile qué hacer con ellos. "Antes de entregar, revisa que..." le indica que debe comprobarlos.
Dónde vive cada pieza
Si tu asistente permite proyectos o asistentes personalizados, pon la parte fija (objetivo, contexto, instrucciones, formato y criterios) en sus instrucciones y pega solo los materiales en cada conversación. Si no, guarda el prompt completo en un documento y cambia solo la sección de materiales.
Práctica
Dedica 25 minutos.
- Toma el prompt que reescribiste en la lección anterior o cualquier prompt que uses seguido.
- Marca con colores o comentarios qué partes corresponden a cada una de las seis piezas.
- Identifica qué pieza falta o está mezclada con otra. Lo más común es que el objetivo no exista y que el formato esté repartido por todo el texto.
- Reescríbelo en el orden recomendado, con una etiqueta para cada pieza.
- Escribe tres criterios de calidad basados en errores que hayas tenido que corregir antes.
- Pruébalo en un chat nuevo con dos entradas distintas y compara con la versión anterior.
Resumen
- Un prompt de trabajo tiene seis piezas: objetivo, contexto, materiales, instrucciones, formato y criterios de calidad.
- El objetivo explica para qué sirve el resultado y ayuda a la IA a decidir qué destacar.
- Explicar el porqué de una regla funciona mejor que la regla sola.
- Con materiales cortos, el contexto va primero; con materiales largos, los documentos van arriba y la pregunta al final.
- Los criterios de calidad deben poder comprobarse con un sí o un no, y se basan en errores reales.