trading-platform/docs/02-definicion-modulos/OQI-007-llm-agent/historias-usuario/US-LLM-007-asistencia-educativa.md
rckrdmrd c1b5081208 feat(ml): Complete FASE 11 - BTCUSD update and comprehensive documentation alignment
ML Engine Updates:
- Updated BTCUSD with Polygon API data (2024-2025): 215,699 new records
- Re-trained all ML models: Attention (R²: 0.223), Base, Metamodel (87.3% confidence)
- Backtest results: +176.71R profit with aggressive_filter strategy

Documentation Consolidation:
- Created docs/99-analisis/_MAP.md index with 13 new analysis documents
- Consolidated inventories: removed duplicates from orchestration/inventarios/
- Updated ML_INVENTORY.yml with BTCUSD metrics and training results
- Added execution reports: FASE11-BTCUSD, correction issues, alignment validation

Architecture & Integration:
- Updated all module documentation with NEXUS v3.4 frontmatter
- Fixed _MAP.md indexes across all folders
- Updated orchestration plans and traces

Files: 229 changed, 5064 insertions(+), 1872 deletions(-)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 09:31:29 -06:00

144 lines
3.3 KiB
Markdown

---
id: "US-LLM-007"
title: "Preguntar Dudas sobre Lecciones"
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-007: Preguntar Dudas sobre Lecciones
**Épica:** OQI-007 - LLM Strategy Agent
**Sprint:** TBD
**Story Points:** 5
**Prioridad:** P1 - Alto
---
## Historia de Usuario
**Como** estudiante en la Academia Trading Platform
**Quiero** poder preguntar dudas sobre los cursos al Copilot
**Para** aclarar conceptos y reforzar mi aprendizaje
---
## Criterios de Aceptación
### AC-1: Explicación de concepto
```gherkin
Given estoy tomando un curso de trading
When pregunto "¿Qué es el RSI?"
Then el agente explica el concepto
And adapta la explicación a mi nivel (beginner/intermediate)
And usa analogías simples si soy principiante
And sugiere la lección relacionada del curso
```
### AC-2: Ayuda contextual en lección
```gherkin
Given estoy en la lección "Indicadores Técnicos"
When pregunto algo sobre la lección
Then el agente sabe qué lección estoy viendo
And responde en contexto de esa lección
And referencia contenido específico
```
### AC-3: NO da respuestas de quiz
```gherkin
Given estoy en un quiz del curso
When pregunto "¿Cuál es la respuesta de la pregunta 3?"
Then el agente NO da la respuesta directa
And explica el concepto relacionado
And sugiere revisar la lección
```
### AC-4: Ejemplo con mercado real
```gherkin
Given aprendí sobre un concepto
When pregunto "¿Puedes mostrarme un ejemplo real?"
Then el agente busca un ejemplo actual en el mercado
And muestra el patrón o concepto en un símbolo real
And explica cómo identificarlo
```
### AC-5: Detecta confusión
```gherkin
Given he preguntado 3+ veces sobre el mismo tema
When hago otra pregunta similar
Then el agente detecta mi confusión
And sugiere un enfoque diferente de explicación
And recomienda revisar material específico
```
---
## Formato de Respuesta Esperado
```markdown
## RSI - Explicación Simple
### ¿Qué es?
El RSI (Relative Strength Index) es un indicador que mide
qué tan "cansado" está el precio de subir o bajar.
### Analogía
Imagina una pelota que lanzas hacia arriba. Mientras más
alto sube, más probable es que empiece a bajar. El RSI
mide qué tan "arriba" está la pelota.
### Cómo interpretarlo
- **RSI > 70:** Sobrecomprado (la pelota está muy arriba)
- **RSI < 30:** Sobrevendido (la pelota está muy abajo)
- **RSI = 50:** Neutral
### Ejemplo Real Actual 📊
Mira AAPL ahora mismo - RSI está en 62, lo que significa
que tiene espacio para subir antes de estar "cansado".
### 📚 Para Profundizar
Te recomiendo la **Lección 3.4: Indicadores de Momentum**
del curso TRD-201.
[Ver Lección →](#)
```
---
## Notas Técnicas
- Integración con módulo educativo (OQI-002)
- Consultar progreso del usuario
- Tool: `get_lesson_content`
- Tool: `get_market_example`
- Detectar preguntas repetitivas para identificar gaps
---
## Dependencias
- RF-LLM-004: Asistencia Educativa
- ET-LLM-004: Integración Educación
- OQI-002: Módulo Educativo
---
## Definición de Done
- [ ] Explicaciones adaptadas a nivel
- [ ] Integración con cursos
- [ ] Ejemplos de mercado real
- [ ] Detección de confusión
- [ ] Tests E2E
- [ ] QA aprobado
---
*Historia de usuario - Sistema NEXUS*
*Trading Platform*