graceful_degradation

Patrón de degradación graceful que permite al sistema continuar operando con funcionalidad reducida cuando un servicio no crítico falla, en lugar de devolver un error total.

When to use

Usar en el apigatewayagent y orchestrator_agent cuando un agente no crítico (antifraud geo-check, age estimation) no responde. El pipeline continúa con penalización de score.

Instructions

1. Clasificar agentes por criticidad:

- Críticos (pipeline se detiene): liveness, facematch, documentprocessor. - No críticos (pipeline continúa): geo-check, age estimation, VPN detection.

1. Si agente no crítico falla, asignar score neutral (0.5) y flag degraded.
2. Incluir en respuesta: "degradedmodules": ["antifraudgeo"].
3. Penalizar score global: reducir confianza en -0.05 por cada módulo degradado.
4. Si > 2 módulos degradados, derivar a MANUAL_REVIEW automáticamente.
5. Registrar modo degradado en métricas y auditoría.
6. Alertar al healthmonitoragent para investigar el servicio caído.

Notes

• Nunca degradar módulos críticos (liveness, face_match); si fallan, retornar error.
• El modo degradado debe ser transparente para el cliente en la respuesta.
• Revisar semanalmente las métricas de degradación para identificar servicios inestables.