127 lines
3 KiB
Markdown
127 lines
3 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. `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
|