rag-service/RAG/docs/PLAYGROUND.md

85 lines
1.8 KiB
Markdown

# Playground del RAG
**Proyecto:** Workspace de tools IA para empresas
**Modulo:** RAG
**Ultima actualizacion:** 2026-04-05
**Ultima modificacion por:** Agente tools IA para potenciar servicios empresariales
**Estado:** Implementado en codigo, pendiente de redeploy
---
## Tecnologia elegida
Se ha elegido una interfaz web estatica simple, servida por el propio backend `Express` del RAG.
### Por que esta opcion
- evita crear un segundo servicio independiente solo para pruebas
- no añade otro framework de frontend ni otro pipeline de build innecesario
- permite iterar rapido sobre el RAG real usando su propia API
- es suficiente para una herramienta interna de evaluacion y ajuste
---
## Ubicacion dentro del modulo
El playground queda dentro de:
```text
RAG/public/playground/
```
Archivos creados:
- `RAG/public/playground/index.html`
- `RAG/public/playground/app.js`
- `RAG/public/playground/styles.css`
El backend lo sirve desde:
```text
/playground
```
---
## Que permite probar
1. `health`
2. `ingest`
3. `retrieve`
4. `answer`
5. `answer` sin RAG para comparar impacto del contexto
6. seleccion explicita del modelo de `answer`
Tambien permite:
- cambiar `mode`
- cambiar `intent`
- ajustar `scope`
- seleccionar el modelo de respuesta
- usar presets para docs, docs del modulo y codigo del RAG
---
## Idea de uso
Este playground no sustituye a clientes finales ni al futuro MCP.
Su papel es:
- probar rapido el comportamiento del RAG
- comparar respuesta con y sin RAG
- validar cambios en ingesta y retrieval
- detectar donde el sistema necesita ajustes
---
## Relacion con MCP
En esta primera fase el playground usa la API HTTP del propio servicio.
Mas adelante se podra:
- mantener como herramienta interna de evaluacion
- o ampliarlo para probar tambien la capa MCP cuando exista