137 lines
3.5 KiB
Markdown
137 lines
3.5 KiB
Markdown
# 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*
|
|
*OrbiQuant IA Trading Platform*
|