La misión: una función, no un oráculo
Elige UNA de las tres rutas sobre tu app del proyecto 3 o 4: A) clasificación —mensajes de soporte → categoría con confirmación de un clic del asignador—; B) extracción —subir el comprobante en PDF → fecha, monto, proveedor con revisión antes de guardar—; C) asistente RAG —preguntas sobre la documentación de tu producto, con fuentes citadas y negativa honesta cuando el dato no está—. Las tres comparten el patrón de M20: la IA propone, un humano o una regla dispone. Lo que hace proyecto (y no demo) a esta entrega: la hoja de costos ANTES del código y la métrica de calidad DESPUÉS del usuario.
La ruta, seis tiempos
Ruta del proyecto 5
- ESPECIFICACION.md: material de entrada acotado, propuesta de la IA (borrador, nunca acción final), control (regla o clic humano) y acción posterior. Define tu métrica: precisión del clasificador medida como «% de casos donde el humano NO corrigió».
El prompt de la capa de IA
Capa IA del proyecto 5 — ruta [A/B/C]. El documento maestro tiene la hoja de costos\naprobada: respetala (tope de tokens de salida, modelo elegido, presupuesto).\n\nFlujo completo, no solo la llamada a la IA:\n1. el material de entrada se filtra segun la minimizacion de ESPECIFICACION.md\n (campos listados: [pegar lista]; lo demas NUNCA viaja, ni al log)\n2. construyes el prompt con plantilla versionada en el codigo (no concatenada a medias)\n3. llamas al proveedor de IA desde el backend con IA_KEY en entorno y timeout de 10 s\n4. la salida se VALIDA contra esquema (campos, tipos, categorias permitidas): salida\n fuera de esquema = se reporta, no se gotea a la interfaz\n5. el resultado es BORRADOR: el usuario confirma o corrige con un clic (ruta A/B) o ve\n las fuentes citadas (ruta C); nada se acciona sin ese paso\n6. guardamos JUNTOS: propuesta + decision final + costo de tokens de esa llamada\n\nCasos de error disenados: la IA no responde (timeout: reintento 1, despues aviso),\nresponde fuera de esquema, o la llamada revienta el presupuesto del dia (candado).\n\nPruebas automatizadas con el proveedor simulado (mock): cada caso arriba. Cuando\neste verde, lo pasamos al proveedor real con una cuenta de gasto minimo.Qué entrega este proyecto
| Entregable | Barra alta de este proyecto |
|---|---|
| ESPECIFICACION.md | la ruta elegida con las cuatro fases del patrón y la métrica definida en una fórmula medible |
| PRUEBAS.md (firma de costos) | la hoja de costos aprobada ANTES del código, con las tres variantes descartadas y por qué |
| HALLAZGOS.md | la salida fuera de esquema que la IA produjo en pruebas, y el hueco de datos que viajaba sin permiso |
| App publicada | función de IA con confirmación humana visible, alarma de presupuesto y primera métrica contada |
Prueba
Tu clasificador de tickets lleva una semana en producción. ¿Qué número responde si «funciona bien»?
Para la ruta C (asistente RAG), basta probar que responda bien las diez preguntas frecuentes: las preguntas sin respuesta en los documentos no merecen prueba porque no existen.
Antes de cualquier prompt de código: la hoja de costos con firma y la lista de campos que pueden viajar a la IA. Cuando la función esté publicada, agenda en tu rutina mensual el conteo de la métrica de correcciones —el número de la semana uno vale más que cualquier impresión sobre el modelo.