trading-platform/docs/02-definicion-modulos/OQI-007-llm-agent/historias-usuario/US-LLM-009-consultar-datos-chat.md

122 lines
2.6 KiB
Markdown

# US-LLM-009: Consultar Datos de Mercado vía Chat
**Épica:** OQI-007 - LLM Strategy Agent
**Sprint:** TBD
**Story Points:** 5
**Prioridad:** P0 - Crítico
---
## Historia de Usuario
**Como** trader usando OrbiQuant
**Quiero** consultar datos de mercado directamente en el chat
**Para** obtener información rápida sin salir de la conversación
---
## Criterios de Aceptación
### AC-1: Consultar precio actual
```gherkin
Given estoy en el Copilot
When pregunto "¿Cuál es el precio de TSLA?"
Then el agente responde con precio actual
And muestra cambio porcentual 24h
And muestra volumen
And la información tiene máximo 15 segundos de antigüedad
```
### AC-2: Consultar múltiples símbolos
```gherkin
Given quiero ver varios precios
When pregunto "¿Cómo están AAPL, MSFT y GOOGL?"
Then el agente muestra tabla comparativa
And incluye precio, cambio y volumen de cada uno
```
### AC-3: Consultar mi watchlist
```gherkin
Given tengo símbolos en mi watchlist
When pregunto "¿Cómo está mi watchlist?"
Then el agente muestra resumen de mis símbolos
And ordena por mayor cambio o criterio relevante
```
### AC-4: Agregar a watchlist
```gherkin
Given menciono un símbolo en la conversación
When digo "Agrega NVDA a mi watchlist"
Then el agente agrega el símbolo
And confirma la acción
And puedo verlo en mi watchlist
```
### AC-5: Consultar indicadores
```gherkin
Given quiero ver indicadores específicos
When pregunto "¿Cuál es el RSI de BTC?"
Then el agente consulta y muestra el valor
And da interpretación del valor
```
---
## Formato de Respuesta
### Precio único
```markdown
## TSLA - Tesla Inc.
**$245.30** (+1.8%)
📊 Vol: 32.5M | 🕐 15:45 ET
High: $248.50 | Low: $242.10
```
### Múltiples símbolos
```markdown
## Resumen de Mercado
| Símbolo | Precio | Cambio | Volumen |
|---------|--------|--------|---------|
| AAPL | $185.50 | +2.3% | 45M |
| MSFT | $378.20 | +1.1% | 22M |
| GOOGL | $142.80 | -0.5% | 18M |
```
---
## Notas Técnicas
- Tools utilizados:
- `get_price`
- `get_watchlist`
- `add_to_watchlist`
- `get_indicators`
- Rate limit: 60 requests/min para precios
- Cache: 5 segundos para datos de precio
---
## Dependencias
- RF-LLM-005.1: Herramienta Market Data
- RF-LLM-005.8: Herramienta Watchlist
- ET-LLM-005: Arquitectura Tools
---
## Definición de Done
- [ ] Consultas de precio funcionando
- [ ] Watchlist integrada
- [ ] Rate limiting implementado
- [ ] Tests E2E
- [ ] QA aprobado
---
*Historia de usuario - Sistema NEXUS*
*OrbiQuant IA Trading Platform*