trading-platform/docs/02-definicion-modulos/OQI-007-llm-agent/historias-usuario/US-LLM-004-ver-senales-ml.md

id	title	type	status	priority	epic	project	story_points	created_date	updated_date
US-LLM-004	Ver Predicciones ML Explicadas	User Story	Done	Media	OQI-007	trading-platform	3	2025-12-05	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

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

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

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

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

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

## 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 OrbiQuant IA Trading Platform