trading-platform/docs/02-definicion-modulos/OQI-007-llm-agent/requerimientos/RF-LLM-004-educational-assistance.md

id	title	type	status	priority	epic	project	version	created_date	updated_date
RF-LLM-004	Asistencia Educativa con LLM	Requirement	Done	Alta	OQI-007	trading-platform	1.0.0	2025-12-05	2026-01-04

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

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

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

## 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
• ET-LLM-005: Análisis de Progreso

---

Historias de Usuario Relacionadas

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

---

Documento de requerimientos - Sistema NEXUS Trading Platform