# 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. `bootstrap`
4. `chat` con contexto precargado
5. `retrieve`
6. `answer`
7. `answer` sin RAG para comparar impacto del contexto
8. 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

---

## Mecanica actual del playground

El playground ya no funciona como una sola caja de consulta tecnica. Ahora se organiza en tres pestañas:

1. `Ingesta`
- lanzar ingesta documental o de codigo

2. `Bootstrap`
- elegir scope
- elegir modo
- cargar un mapa inicial del dominio
- opcionalmente pedir a un modelo que sintetice ese bootstrap
- reemplazar o vaciar el contexto de sesion

3. `Chat`
- conversar con el modelo
- ver visualmente si hay contexto cargado o no
- reutilizar el ultimo bootstrap como contexto base
- permitir que el modelo haga consultas adicionales al RAG durante la conversacion

### Indicador visual de contexto

En la pestaña `Chat` hay un indicador visual:

- rojo: no hay bootstrap cargado
- verde: hay contexto bootstrap activo

Tambien se muestra el `scope` actualmente cargado.

### Chat con consultas adicionales al RAG

El chat ya soporta dos niveles:

1. respuesta usando solo el bootstrap cargado
2. respuesta usando bootstrap y, si se activa la opcion correspondiente, una consulta adicional al RAG durante la conversacion

Esto permite aproximar mejor el comportamiento esperado de una app o agente conectado al servicio.

---

## 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