# RF-LLM-004: Asistencia Educativa con LLM

**Épica:** OQI-007 - LLM Strategy Agent
**Versión:** 1.0
**Fecha:** 2025-12-05
**Estado:** Planificado
**Prioridad:** P1 - Alto

---

## Descripción

El agente LLM debe funcionar como tutor personalizado de trading, capaz de explicar conceptos, responder dudas sobre los cursos, y adaptar las explicaciones al nivel del usuario. Debe integrarse con el módulo educativo (OQI-002).

---

## Requisitos Funcionales

### RF-LLM-004.1: Explicación de Conceptos
- El agente debe explicar términos de trading al nivel del usuario
- El agente debe usar analogías y ejemplos prácticos
- El agente debe adaptar complejidad según experiencia
- El agente debe detectar confusión y reformular explicaciones
- El agente debe proveer recursos adicionales cuando sea útil

### RF-LLM-004.2: Asistencia en Cursos
- El agente debe conocer el progreso del usuario en los cursos
- El agente debe responder preguntas sobre lecciones específicas
- El agente debe aclarar conceptos de las evaluaciones
- El agente debe NO dar respuestas directas a quizzes
- El agente debe sugerir repasar lecciones cuando detecte gaps

### RF-LLM-004.3: Mentoría Personalizada
- El agente debe identificar áreas de mejora
- El agente debe sugerir siguiente paso de aprendizaje
- El agente debe celebrar logros y progreso
- El agente debe mantener tono motivacional pero realista
- El agente debe recordar contexto de conversaciones previas

### RF-LLM-004.4: Conexión Teoría-Práctica
- El agente debe conectar conceptos con mercado real
- El agente debe mostrar ejemplos actuales de patrones
- El agente debe explicar cómo aplicar lo aprendido
- El agente debe simular escenarios para práctica

### RF-LLM-004.5: Multi-idioma
- El agente debe responder en español e inglés
- El agente debe detectar idioma preferido del usuario
- El agente debe mantener terminología técnica consistente

---

## Criterios de Aceptación

```gherkin
Feature: Asistencia Educativa

Scenario: Explicar concepto de trading
  Given soy usuario principiante
  When pregunto "¿Qué es el RSI?"
  Then el agente explica RSI con lenguaje simple
  And usa analogías comprensibles
  And muestra ejemplo visual si es posible
  And sugiere la lección relacionada del curso

Scenario: Asistencia durante curso
  Given estoy en la lección "Indicadores Técnicos"
  And tengo progreso del 40% en el módulo
  When pregunto "No entiendo las bandas de Bollinger"
  Then el agente explica específicamente Bandas de Bollinger
  And referencia contenido de la lección
  And NO revela respuestas del quiz
  And sugiere revisar sección específica

Scenario: Detección de gaps de conocimiento
  Given tengo 5 conversaciones sobre "soportes y resistencias"
  And mis preguntas indican confusión persistente
  When inicio nueva conversación sobre el tema
  Then el agente detecta el gap
  And sugiere enfoque diferente de aprendizaje
  And recomienda lección de refuerzo

Scenario: Conexión con mercado real
  Given aprendí sobre "patrones de velas"
  When pregunto "¿Puedes mostrarme un ejemplo real?"
  Then el agente busca patrón reciente en mercado
  And muestra símbolo con el patrón
  And explica cómo identificarlo
```

---

## Reglas de Negocio

| Regla | Descripción |
|-------|-------------|
| RN-001 | No dar respuestas directas a quizzes o evaluaciones |
| RN-002 | Adaptar vocabulario al nivel del usuario |
| RN-003 | Siempre mencionar que práctica en paper trading es recomendada |
| RN-004 | No hacer promesas de rentabilidad en explicaciones |
| RN-005 | Máximo 3 sugerencias de cursos por conversación |
| RN-006 | Acceso educativo básico para todos los planes |

---

## Dependencias

### Épicas Requeridas
- **OQI-001:** Autenticación y perfil de usuario
- **OQI-002:** Catálogo de cursos y progreso

### APIs Externas
- OpenAI/Claude (análisis LLM)
- Course database (OQI-002)

---

## Datos de Entrada

```yaml
user_context:
  level: "beginner"
  courses_completed: ["TRD-101"]
  current_course: "TRD-201"
  current_lesson: "technical-indicators"
  progress: 40
  quiz_scores:
    - lesson: "candlesticks"
      score: 70
    - lesson: "support-resistance"
      score: 55

conversation_history:
  - topic: "support-resistance"
    questions_count: 5
    understood: false
  - topic: "trend-lines"
    questions_count: 2
    understood: true

question: "¿Puedes explicarme de nuevo los niveles de soporte?"
```

---

## Formato de Respuesta

```markdown
## Niveles de Soporte - Explicación Personalizada

### Concepto Simple
Imagina el precio de una acción como una pelota que rebota.
El **soporte** es como el piso donde la pelota rebota hacia arriba.

### ¿Por qué funciona?
- Muchos traders tienen órdenes de compra en ese nivel
- Cuando el precio llega ahí, las compras hacen que suba
- Es un nivel donde históricamente el precio "se detiene"

### Ejemplo Real Actual
📊 Mira AAPL en este momento:
- Soporte fuerte en $180 (rebotó 3 veces este mes)
- Cada vez que tocó $180, subió

### Ejercicio Práctico
1. Abre el chart de AAPL en la plataforma
2. Identifica dónde el precio rebotó múltiples veces
3. Esos son tus niveles de soporte

### 📚 Recurso Sugerido
He notado que este tema te ha costado un poco.
Te recomiendo revisar la **Lección 3.2: Soportes y Resistencias**
del curso TRD-201 - hay un video muy claro.

[Ver Lección →](link-a-leccion)

💪 ¡No te desanimes! Este concepto toma práctica para dominarlo.
```

---

## Especificaciones Técnicas Relacionadas

- [ET-LLM-004: Integración Módulo Educativo](../especificaciones/ET-LLM-004-integracion-educacion.md)
- [ET-LLM-005: Análisis de Progreso](../especificaciones/ET-LLM-005-analisis-progreso.md)

---

## Historias de Usuario Relacionadas

- US-LLM-007: Preguntar dudas sobre lecciones
- US-LLM-008: Recibir recomendaciones de aprendizaje

---

*Documento de requerimientos - Sistema NEXUS*
*OrbiQuant IA Trading Platform*
