Manual práctico · Markdex IA

Ingeniería de prompts: guía práctica

Cómo redactar instrucciones que un modelo de lenguaje ejecuta de forma predecible. Procedimiento en seis bloques, ejemplos por caso de uso, corrección de fallos y criterios de verificación.

Ir a los pasos Ver ejemplos

Bloques de un prompt

Variable por iteración

Datos sensibles dentro

Qué es un prompt y por qué determina el resultado

Un prompt es la especificación de entrada que se entrega a un modelo de lenguaje. Conviene entender el mecanismo: el modelo no interpreta una intención, calcula la continuación más probable del texto recibido, condicionada por cada palabra previa. Por eso el vocabulario, el orden de las instrucciones y la presencia de ejemplos modifican el resultado de forma medible. Una instrucción ambigua produce salidas distintas en ejecuciones distintas; una instrucción con formato cerrado reduce esa variación.

Importante entender la diferencia entre conversación y especificación. En una conversación se admiten sobreentendidos; en una especificación, no. Si el prompt no indica la audiencia, la longitud y el formato, el modelo elegirá por defecto y lo hará de manera inconsistente. Por eso la ingeniería de prompts se apoya en los mismos principios que la documentación técnica: contexto explícito, tarea única, restricciones enumeradas y criterio de aceptación verificable.

Antes de escribir instrucciones complejas, revise los conceptos de contexto, token y temperatura en Fundamentos de automatización con IA. Después, esta guía y el apartado de flujos de trabajo automatizados permiten encadenar prompts con pasos no generativos.

Estructura de un prompt: seis bloques en orden fijo

Redacte los bloques en este orden. Cada uno responde a una pregunta distinta y, si se omiten, el modelo rellena el vacío con supuestos propios.

Paso 1. Defina rol y alcance

Indique qué función debe asumir el modelo y hasta dónde llega su tarea. Ejemplo: «Actúa como revisor de contratos de suministro. Analiza únicamente las cláusulas de penalización del texto delimitado».
Paso 2. Aporte contexto y datos de entrada

Delimite el material con marcadores claros <<< ... >>>. El modelo distingue así entre instrucciones y contenido a procesar. Incluya solo el fragmento necesario: el contexto irrelevante diluye la señal y aumenta el coste por ejecución.
Paso 3. Formule una tarea con un verbo de acción único

«Extrae», «clasifica», «reescribe» o «resume». Dos verbos en el mismo prompt generan ejecuciones parciales: el modelo atiende uno y descuida el otro.
Paso 4. Enumere restricciones y prohibiciones

Longitud máxima, tono, datos que no deben aparecer, suposiciones no permitidas. Las restricciones se escriben como lista, no como párrafo corrido.
Paso 5. Fije el formato de salida

Describa la estructura exacta: claves de un objeto JSON, número de viñetas o tabla con columnas definidas. Un formato explícito elimina la mayor parte de las correcciones posteriores.
Paso 6. Añada el criterio de verificación

Indique cómo se comprobará la respuesta: «si un dato no aparece en el contexto, escribe NO DISPONIBLE». Este paso convierte la salida en algo auditable.

⚠ ATENCIÓN

No incluya credenciales, claves de API ni datos personales dentro del prompt. Todo lo que se envía al modelo queda registrado en la traza de la herramienta. Use identificadores y sustituya los datos reales por marcadores.

Ejemplos de prompt por caso de uso

Cada plantilla parte de la estructura de seis bloques y cambia solo la tarea y el formato de salida. Revise el caso más cercano a su proceso y ajuste los límites.

Extracción

Datos de facturas

Tarea: extrae número, fecha, base imponible e IVA. Formato: JSON con cuatro claves fijas, sin texto adicional fuera del objeto.

Ver fundamentos

Clasificación

Triaje de incidencias

Tarea: asigna cada incidencia a una de cuatro categorías cerradas. Restricción: si el texto no encaja, devuelve SIN CLASIFICAR.

Ver agentes autónomos

Redacción

Respuesta a reclamación

Tarea: redacta un borrador de 120 palabras. Restricciones: sin promesas de plazo ni compromisos económicos. Salida en texto plano.

Ver método para pymes

Control

Verificación de salidas

Tarea: revisa una respuesta contra la lista de criterios y devuelve APTO o NO APTO con la línea incumplida. Sin explicaciones adicionales.

Ver flujos automatizados

Síntesis

Resumen de reunión

Tarea: resume la transcripción en cinco viñetas y una lista de decisiones. Restricción: no atribuyas tareas a personas que no aparecen citadas.

Ver glosario y recursos

Documentación

Ficha de producto

Tarea: genera una ficha con tres apartados fijos a partir de las especificaciones aportadas. Prohibido añadir características no incluidas en la entrada.

Volver al manual

Ajuste iterativo: cómo corregir sin reescribir todo

Un prompt rara vez queda correcto en el primer intento. Lo importante es cambiar una sola variable por iteración: si modifica el formato, la longitud y el tono al mismo tiempo, no podrá saber qué mejora produjo el cambio. Mantenga una versión numerada de cada plantilla y un conjunto fijo de cinco a diez entradas de prueba que no varíe entre versiones; así la comparación es válida.

Registre para cada iteración el resultado observado y la causa probable. Este registro convierte el ajuste en un proceso reproducible y permite que otra persona del equipo continúe el trabajo sin reconstruir el razonamiento.

1. Ejecute el prompt con el banco de pruebas completo y guarde las salidas.
2. Identifique la desviación dominante y traduzca el fallo a un bloque concreto.
3. Modifique únicamente ese bloque y vuelva a ejecutar el mismo banco.
4. Archive la versión que supere los criterios y anote los límites conocidos.

Errores frecuentes al escribir prompts

Los fallos siguientes explican la mayor parte de las salidas inservibles. Revise esta lista antes de añadir más instrucciones: casi siempre sobra texto, no falta.

Instrucciones acumuladas sin orden: Si el prompt crece por capas, las restricciones nuevas contradicen las anteriores. Reescriba el documento completo cada tres iteraciones en lugar de añadir líneas al final.
Contenido y órdenes mezclados: El texto a procesar debe ir delimitado y separado. Si se mezcla con las órdenes, el modelo puede ejecutar frases del propio documento como si fueran instrucciones.
Formato descrito en prosa: «Devuélvelo ordenado» no es una especificación. Escriba las claves, el número de elementos y el orden exacto que necesita el paso siguiente del proceso.
Confiar en la memoria del modelo: Cada ejecución parte de cero. Los datos necesarios deben estar dentro del prompt, no en una conversación anterior ni en un documento que el modelo no ha recibido.

Posibles fallos y su corrección

Localice el síntoma en la primera columna y aplique la corrección indicada. No cambie más de un bloque a la vez.

Síntoma	Causa probable	Corrección
Respuestas genéricas	Falta rol y audiencia	Añada dos líneas de contexto y el destinatario de la salida
Formato inconsistente	Estructura descrita en prosa	Defina esquema con claves fijas y sin texto fuera del objeto
Omite parte de la tarea	Dos verbos en un mismo prompt	Divida en dos prompts secuenciales encadenados
Inventa datos	No se define qué hacer ante la falta de información	Instruya responder NO DISPONIBLE si el dato no está en el contexto
Longitud excesiva	Sin límite explícito de salida	Fije número máximo de palabras o de viñetas

Resumen operativo

Un prompt correcto cumple cuatro condiciones: tarea única, contexto delimitado, formato cerrado y criterio de verificación. Si falta una de ellas, la salida requerirá revisión manual y el coste de la automatización sube.

bloques obligatorios antes de la primera ejecución

entradas fijas recomendadas en el banco de pruebas

variable modificada por iteración, sin excepciones

Continúe con la integración de agentes autónomos para encadenar estos prompts con herramientas reales, o revise el glosario y recursos para fijar la terminología del equipo.