El incidente ya está contenido. El error budget dejó de sangrar. El canal on-call se calmó. Lo que sigue —si el equipo es serio— no es “volver a lo de siempre”, sino un postmortem blameless: un ritual estructurado para convertir el dolor operativo en aprendizaje accionable. Sin señalamientos personales. Con timeline, evidencia y dueños de las acciones.
Este artículo cierra el arco operativo que venimos armando: de la observabilidad y el triage en 30 minutos, pasando por SLOs y error budget, hasta el checklist de freeze y rollback. Aquí el foco es cómo aprender de lo que falló —modelo, prompt, datos, orquestación u ownership— sin repetir el mismo incidente el mes siguiente.
Qué es (y qué no es) un postmortem de IA
Un postmortem blameless de incidentes de IA es un documento y una reunión con un objetivo claro: entender qué falló en el sistema socio-técnico (código, modelo, datos, procesos y decisiones humanas) para que no vuelva a pasar con la misma severidad. “Blameless” no significa “sin responsabilidad”. Significa que se investigan causas y condiciones, no culpables. Se pregunta “¿qué hizo que una persona razonable tomara esa decisión con la información disponible?”, no “¿quién rompió el prompt?”.
No es un postmortem de IA:
- Un chat de Slack con conclusiones orales y cero registro.
- Una cacería de brujas (“el data scientist metió mal el few-shot”).
- Un ticket cerrado con “fue el modelo” sin hipótesis verificable.
- Una presentación para el board sin acciones con dueño y fecha.
- Una retrospectiva de producto disfrazada: aquí el trigger es un incidente de producción, no un sprint review.
En servicios de IA el postmortem tiene matices propios. El “bug” puede ser semántico (calidad), estadístico (drift), de latencia (colas, cold start) o de gobierno (cambio sin change control). La evidencia incluye prompts, versiones de modelo, umbrales, muestreos de calidad y logs de tools —no solo stack traces.
Cuándo dispararlo: error budget, SEV y degradación
No todo ping merece un postmortem de dos horas. Define umbrales escritos. Una regla práctica para mid-market en México y LatAm:
- SEV-1 / SEV-2 (cliente crítico impactado, fuga de datos, indisponibilidad amplia): postmortem obligatorio en ≤5 días hábiles.
- Error budget agotado o burn rate sostenido que forzó freeze: postmortem obligatorio, aunque el servicio “ya esté verde”.
- Degradación prolongada (calidad bajo umbral >N horas, degradación controlada mal comunicada, HITL desbordado): postmortem recomendado.
- Near-miss (casi SEV, detectado a tiempo): postmortem ligero (45–60 min) si el mismo patrón ya ocurrió dos veces.
Si el incidente activó el protocolo de freeze/rollback, el postmortem debe referenciar ese ticket y el estado del presupuesto. El aprendizaje no compite con la contención: la sucede.
Timeline y evidencia: qué recolectar antes de la reunión
El 70% de un buen postmortem se gana (o se pierde) en la preparación. El facilitador o el incident commander deja listo un timeline con marcas de tiempo en zona CT y enlaces a evidencia. Mínimo:
- Métricas. Latencia p95/p99, tasa de error, tasa de degradación, burn del error budget, volumen por segmento.
- Alertas y triage. Quién recibió el ping, qué runbook se abrió, qué se contuvo y a qué hora.
- Versiones. Modelo/proveedor, prompt (hash o id), umbrales, índice de retrieval, feature flags, deploy IDs.
- Datos y muestreo. Ejemplos de inputs problemáticos (anonimizados), rúbrica de calidad, tasa de rechazo humano.
- Cambios recientes. Diffs de prompt, merges, cambios de umbral, rotaciones de ownership —cruzados con el change control de IA.
Evita pegar capturas sueltas sin contexto. Cada ítem del timeline debe responder: ¿qué observamos?, ¿qué cambió?, ¿qué decidimos? Si falta telemetría, anótalo como hallazgo: “no teníamos muestreo de calidad por segmento” es tan accionable como “el prompt X introdujo regresiones”.
Causas raíz típicas en incidentes de IA
Usa categorías para no quedarte en “el modelo alucinó”. Hipótesis frecuentes en producción B2B:
- Datos. Drift de distribución, schema roto, PII inesperada, corpus de retrieval desactualizado o contaminado.
- Prompt / plantilla. Instrucciones ambiguas, few-shots sesgados, system message que colisiona con tools, falta de formato estricto.
- Modelo. Cambio de versión del proveedor, comportamiento distinto bajo carga, límites de contexto, costo que forzó un downgrade silencioso.
- Orquestación. Timeouts, reintentos que duplican side-effects, routing incorrecto entre modelos, tools con permisos de más.
- Umbrales. Auto-aprobación demasiado agresiva, score calibrado en otro segmento, guardrails desactivados “temporalmente”.
- Ownership y proceso. Cambio sin aprobación, on-call sin runbook, métrica mal definida, SLO negociado pero no instrumentado.
La causa raíz rara vez es una sola. Documenta la cadena: cambio de umbral → más auto-aprobaciones → muestreo en rojo → burn de calidad → freeze. El postmortem blameless privilegia la cadena sobre el chivo expiatorio.
Plantilla de secciones (cópiala al ticket)
Estructura mínima, en español, lista para Notion/Confluence/Jira:
- Resumen ejecutivo (5–8 líneas). Qué pasó, impacto (clientes, $, SLO), duración, estado actual.
- Severidad y trigger. SEV, alertas, si hubo freeze o rollback.
- Timeline. Tabla hora CT → evento → evidencia.
- Impacto. Usuarios afectados, tickets, reproceso, CSAT, costo de modelo/HITL.
- Causas raíz (cadena). Categorías + evidencia. Separar causa inmediata vs condiciones latentes.
- Qué funcionó. Detección, contención, comunicación —refuerza lo que sí hay que repetir.
- Acciones correctivas. Fixes que cierran el incidente o su variante inmediata.
- Acciones preventivas. Controles, tests, muestreo, change control, SLOs.
- Dueños, fechas y criterio de done. Sin esto, el postmortem es teatro.
- Lecciones para gobierno. ¿Hay que renegociar un SLO? ¿Ampliar el freeze policy?
Acciones correctivas vs preventivas
Correctivas restauran o endurecen el estado actual: rollback de prompt, recalibrar umbral, parche de retrieval, más HITL en el segmento roto, alertas que faltaban. Deben cerrarse rápido (días).
Preventivas reducen la probabilidad o el blast radius a futuro: tests de regresión de prompts en CI, canary obligatorio, rúbrica de muestreo por segmento, ownership claro en el change control, runbook actualizado, budget de calidad con bandas sano/tenso/agotado. Horizontes de 1–4 semanas.
Regla: cada causa raíz del documento debe mapear al menos a una acción con dueño. Si la acción es “mejorar la cultura”, reformúlala: “añadir checklist de pre-deploy de prompts al PR template” es cultura operativa, no un eslogan.
Ritual de follow-up y vínculo con change control / SLOs
Agenda el postmortem 2–5 días después del incidente (no a las 2 a.m.). 45–75 minutos. Roles: facilitador (no el único “culpable” percibido), scribe, incident commander, owners de modelo/prompt/datos, un representante de producto.
Al cierre:
- Publica el documento en un lugar searchable (no solo el hilo de Slack).
- Abre tickets de acciones con labels postmortem y enlace al incidente.
- Revisa en 14 días: ¿se cerraron las correctivas? ¿Las preventivas tienen diseño?
- Si el incidente quemó error budget, alimenta el ritual de renegociación de SLOs con hechos del postmortem —no con sensaciones.
- Si hubo cambio fuera de política, actualiza el checklist de change control y el path de aprobación.
Así el loop queda cerrado: detectar → contener → aprender → gobernar el siguiente cambio. Sin ese loop, los SLOs son un dashboard bonito y el freeze una anécdota.
Checklist corto (imprimible)
- ☐ ¿Hubo SEV, freeze o error budget agotado? → postmortem calendarizado.
- ☐ Timeline con métricas, versiones, prompts, muestreo y cambios recientes.
- ☐ Causas en cadena (datos / prompt / modelo / orquestación / umbrales / ownership).
- ☐ Acciones correctivas y preventivas con dueño, fecha y criterio de done.
- ☐ Documento publicado + tickets abiertos + follow-up a 14 días.
- ☐ Lecciones reflejadas en change control y, si aplica, en renegociación de SLOs.
Cierre
Un postmortem blameless no absuelve al sistema: lo obliga a mejorar. En IA de producción, donde el fallo puede ser estadístico o semántico, el aprendizaje operativo es el puente entre el triage del día y el gobierno del trimestre. Si ya tienes observabilidad, runbooks, SLOs y freeze, este ritual es lo que convierte incidentes en ventaja competitiva —equipos que fallan una vez y documentan, contra equipos que fallan en silencio cada sprint.
¿Quieres diseñar el ritual de postmortem, las plantillas y el amarre con SLOs y change control para tus flujos de IA en producción? En NextWave ayudamos a equipos mid-market en México y LatAm a cerrar el loop de confiabilidad con gobierno aplicado. Escríbenos a contacto@nextWaveAI.AI o llama al +52 (33) 3126 6969.

Add comment