---
id: "US-LLM-004"
title: "Ver Predicciones ML Explicadas"
type: "User Story"
status: "Done"
priority: "Media"
epic: "OQI-007"
project: "trading-platform"
story_points: 3
created_date: "2025-12-05"
updated_date: "2026-01-04"
---

# US-LLM-004: Ver Predicciones ML Explicadas

**Épica:** OQI-007 - LLM Strategy Agent
**Sprint:** TBD
**Story Points:** 5
**Prioridad:** P0 - Crítico

---

## Historia de Usuario

**Como** usuario Pro o Premium
**Quiero** ver las predicciones del modelo ML explicadas en lenguaje natural
**Para** entender qué predice el modelo y por qué, y usarlo en mis decisiones

---

## Criterios de Aceptación

### AC-1: Ver predicción ML básica
```gherkin
Given soy usuario Pro o Premium
When pregunto "¿Qué dice el ML sobre AAPL?"
Then el agente responde con:
  | Campo | Contenido |
  | Predicción | Dirección (bullish/bearish/neutral) |
  | Confianza | Porcentaje de confianza |
  | Horizonte | Timeframe de la predicción |
  | Explicación | Por qué el modelo predice esto |
```

### AC-2: Explicación de features
```gherkin
Given pido detalles de la predicción ML
When pregunto "¿Por qué el ML predice eso?"
Then el agente explica las principales features
And muestra qué indicadores influyeron más
And traduce los términos técnicos a lenguaje simple
```

### AC-3: Restricción por plan
```gherkin
Given soy usuario Free
When pregunto "¿Qué dice el ML sobre TSLA?"
Then el agente responde que las señales ML requieren plan Pro
And muestra opción de upgrade
And NO muestra predicciones
```

### AC-4: Precisión histórica
```gherkin
Given pido información sobre el modelo
When pregunto "¿Qué tan preciso es el ML?"
Then el agente muestra precisión histórica del modelo
And explica qué significa el porcentaje
And incluye disclaimer sobre rendimiento pasado
```

### AC-5: Combinación con análisis técnico
```gherkin
Given pido análisis completo
When digo "Analiza NVDA con señales ML"
Then el agente combina:
  - Análisis técnico tradicional
  - Predicción ML con explicación
  - Conclusión que integra ambos
```

---

## Formato de Respuesta Esperado

```markdown
## Señales ML para AAPL 🤖

### Predicción
📈 **Alcista** con 72% de confianza

### Horizonte
Próximas 4 horas

### Por qué el modelo predice esto
El modelo detecta:
1. **Momentum positivo** - RSI y MACD alineados
2. **Volumen creciente** - Indica interés comprador
3. **Patrón de precio** - Consolidación sobre soporte

### Features Principales
| Feature | Peso | Valor Actual |
|---------|------|--------------|
| RSI momentum | 23% | Positivo |
| Volume profile | 18% | Acumulación |
| Price pattern | 15% | Bullish flag |

### Precisión Histórica
El modelo ha tenido 68% de precisión en predicciones
similares para AAPL en los últimos 30 días.

⚠️ *Las predicciones ML son herramientas de apoyo, no garantías.
El rendimiento pasado no garantiza resultados futuros.*
```

---

## Notas Técnicas

- Tool: `get_ml_signals` para obtener predicción
- Tool: `get_ml_features` para explicación detallada (Premium)
- Integración con ML Engine (OQI-006)
- Cache de predicciones: 60 segundos
- Solo disponible para símbolos soportados por el modelo

---

## Dependencias

- RF-LLM-002.4: Integración con Señales ML
- ET-LLM-002: Agente de Análisis
- OQI-006: ML Signals

---

## Definición de Done

- [ ] Integración con ML Engine
- [ ] Explicación en lenguaje natural
- [ ] Restricción por plan
- [ ] Precisión histórica mostrada
- [ ] Disclaimers incluidos
- [ ] Tests E2E
- [ ] QA aprobado

---

*Historia de usuario - Sistema NEXUS*
*Trading Platform*
