Proyecto Final: Construye un Prompt de Producción

🔄 Repaso rápido: A lo largo de 7 lecciones aprendiste el framework RACE, anatomía de prompts, personas, few-shot learning, cadena de pensamiento, patrones y depuración. Ahora es momento de ponerlo todo junto en un proyecto real.

Poniendo Todo Junto

Aprendiste las piezas. Ahora vamos a construir algo real.

Esta lección te guía en la creación de un prompt listo para producción desde cero. No un ejemplo de juguete — algo que podrías desplegar en un sistema o flujo de trabajo real.

Vamos a seguir un proceso sistemático, aplicando técnicas de cada lección anterior.

El Escenario

Construyamos un prompt para un caso de uso realista:

Tarea: Clasificador de tickets de soporte al cliente

Requisitos:

• Clasificar tickets entrantes en categorías
• Extraer información clave (urgencia, producto, tipo de problema)
• Marcar tickets que necesitan escalamiento humano
• Funcionar confiablemente con entradas variadas

Esta es una tarea real por la que las empresas pagan. Vamos a resolverla con un prompt.

Paso 1: Define el Éxito

Antes de escribir nada, ten claro cómo se ve el éxito.

Una buena salida debe:

• Categorizar tickets correctamente 95%+ de las veces
• Extraer campos estructurados de forma consistente
• Nunca perder un ticket que necesita escalamiento
• Manejar tickets confusos o multi-problema con gracia
• Devolver datos estructurados y parseables

✅ Quick Check: ¿Por qué es fundamental definir criterios de éxito ANTES de escribir el prompt?

Respuesta: Porque si no sabes cómo se ve una buena salida, no tienes forma de evaluar ni mejorar tu prompt. Los criterios te dan un estándar objetivo contra el cual medir.

Paso 2: Define la Estructura

Usando el framework RACE:

Rol: Agente de soporte experto con experiencia en clasificación de tickets Acción: Clasificar ticket, extraer información, determinar escalamiento Contexto: Lista de categorías, reglas de escalamiento, formato de salida Ejemplos: Tickets representativos mostrando salidas esperadas

Paso 3: Escribe el Primer Borrador

Construyamos pieza por pieza.

La Persona:

Eres un especialista de soporte al cliente experimentado que clasifica tickets entrantes. Has procesado miles de tickets y puedes identificar rápidamente el problema central, nivel de urgencia y categoría apropiada.

Definición de Tarea:

Para cada ticket de soporte, debes:
1. Categorizar en el departamento apropiado
2. Extraer información clave
3. Determinar nivel de urgencia
4. Marcar si se necesita escalamiento humano

Contexto (Categorías y Reglas):

CATEGORÍAS:
- Facturación: Pagos, facturas, reembolsos, problemas de suscripción
- Técnico: Bugs, errores, problemas de integración, caídas
- Cuenta: Problemas de login, reset de contraseña, cambios de perfil
- Funcionalidad: Solicitudes de funciones, sugerencias, feedback
- General: Todo lo que no encaje arriba

NIVELES DE URGENCIA:
- Crítico: Sistema caído, pérdida de datos, problema de seguridad
- Alto: Función principal no funciona, error de facturación
- Medio: Función parcialmente rota, preguntas generales
- Bajo: Solicitudes de funciones, problemas menores, feedback general

DISPARADORES DE ESCALAMIENTO (siempre marcar para revisión humana):
- Menciona acción legal o abogado
- Menciona medios, prensa o amenazas en redes sociales
- Usa lenguaje agresivo o grosero
- Menciona preocupaciones de seguridad
- Solicita eliminación de datos (GDPR/privacidad)

Formato de Salida + Ejemplos:

FORMATO (responde SOLO con JSON válido):
{
  "category": "Facturación|Técnico|Cuenta|Funcionalidad|General",
  "urgency": "Crítico|Alto|Medio|Bajo",
  "needs_escalation": true|false,
  "escalation_reason": "string o null",
  "product": "producto identificado o null",
  "summary": "resumen en una oración",
  "sentiment": "Positivo|Neutro|Negativo|Enojado"
}

---
Ticket: "Me cobraron doble la suscripción este mes. Pedido #45231. Arreglen esto ya."

{"category": "Facturación", "urgency": "Alto", "needs_escalation": false,
 "escalation_reason": null, "product": "Suscripción",
 "summary": "Cliente reporta cobro doble de suscripción", "sentiment": "Negativo"}
---
Ticket: "La función de exportar lleva 3 días sin funcionar y mi equipo está bloqueado. Si no lo arreglan hoy cancelo y publico reseñas en todas partes."

{"category": "Técnico", "urgency": "Crítico", "needs_escalation": true,
 "escalation_reason": "Amenaza de reseñas negativas públicas",
 "product": "Función de exportar",
 "summary": "Caída crítica de exportación bloqueando equipo por 3 días",
 "sentiment": "Enojado"}
---

Paso 4: Prueba y Refina

Prueba con Casos Normales

Prueba con varios tickets típicos: una pregunta de facturación, un reporte de bug, un problema de cuenta, una solicitud de funcionalidad.

Verifica: ¿El formato coincide? ¿Las categorías son correctas?

Prueba con Casos Límite

Ticket ambiguo:

“Nada funciona. Arreglen esto.”

Debería clasificar como Técnico/Medio y mencionar falta de detalles en el resumen.

Ticket multi-problema:

“Mi suscripción se renovó pero las nuevas funciones no aparecen y tampoco puedo cambiar mi contraseña.”

Debería identificar el problema principal o marcar como complejo.

Disparador de escalamiento:

“Esto es inaceptable. Voy a llamar a mi abogado.”

DEBE marcar escalamiento con razón legal.

Depura Problemas

Si algo no funciona, usa las técnicas de depuración: ¿Qué salida específica está mal? Aísla la causa. Agrega o modifica ejemplos.

Paso 5: Documenta y Versiona

Para prompts de producción, mantén:

# Clasificador de Tickets v1.2

## Propósito
Clasificar y extraer información de tickets de soporte.

## Historial de Versiones
- v1.0: Prompt inicial
- v1.1: Agregado disparador de escalamiento GDPR
- v1.2: Mejorado manejo de tickets multi-problema

## Limitaciones Conocidas
- Puede fallar con tickets altamente técnicos
- Tickets en otros idiomas necesitan prompt separado

## Resultados de Pruebas
- Precisión en set de prueba: 96%
- Recall de escalamiento: 100%

Lo Que Aprendiste

En 8 lecciones, dominaste:

Ya no solo escribes prompts. Los ingenieras.

Key Takeaways

• Empieza con criterios de éxito — sabe cómo se ve una buena salida
• Construye prompts sistemáticamente usando el framework RACE
• Prueba con casos normales Y casos límite
• Documenta y versiona prompts de producción
• Aplica el kit completo: persona, ejemplos, patrones, depuración

Felicitaciones por completar Ingeniería de Prompts. Ahora ve y construye algo útil.