93 lines
7 KiB
Markdown
93 lines
7 KiB
Markdown
# Historial de sesiones
|
|
|
|
**Proyecto:** Workspace de tools IA para empresas
|
|
**Modulo:** RAG
|
|
**Ultima actualizacion:** 2026-09-08
|
|
**Ultima modificacion por:** Agente RAG 2
|
|
**Estado:** Activo
|
|
|
|
---
|
|
|
|
## Registro de sesion
|
|
|
|
### 2026-04-06 - Agente RAG 2
|
|
|
|
**Modelo:** gpt-5.4
|
|
**Conversation ID:** `N/D (OpenCode no lo expone en este entorno)`
|
|
**Session ID OpenCode:** `ses_29bdbd003ffeLrLjUlFgnp08Y7`
|
|
**Directorio:** `/home/pancho/Documentos/Empresa/Desarrollo/IA`
|
|
|
|
**Rol asumido:**
|
|
Dar continuidad al RAG en `RAG/` a partir del estado actual documentado.
|
|
|
|
**Contexto recuperado:**
|
|
- No existe `README` en la raiz de `RAG/`.
|
|
- La base documental principal revisada ha sido:
|
|
- `docs/SISTEMA_RAG_BASE.md`
|
|
- `docs/BITACORA_DISENO_RAG.md`
|
|
- `docs/METODOLOGIA_ITERACION_Y_REDEPLOY.md`
|
|
- `docs/PLAYGROUND.md`
|
|
- `docs/LOGS_EVALUACION.md`
|
|
- La v1 figura como operativa y desplegada en `https://rag.por-correo.com`.
|
|
- Endpoints documentados como operativos: `GET /health`, `POST /ingest`, `POST /retrieve`, `POST /answer`.
|
|
- El playground y los logs de evaluacion aparecen implementados en codigo y pendientes de redeploy segun la documentacion.
|
|
|
|
**Criterio de continuidad asumido:**
|
|
- Trabajar desde el estado ya documentado, sin redescubrir decisiones nucleares de la v1.
|
|
- Mantener actualizada la documentacion relevante cuando se hagan cambios reales.
|
|
- Usar este historial para dejar trazabilidad entre sesiones y agentes.
|
|
|
|
**Trabajo realizado en esta sesion:**
|
|
- Auditoria inicial de documentacion, codigo y estado observable del modulo `RAG/`.
|
|
- Registro de un reporte temporal de auditoria de modelo en `RAG/docs/TEMP_AUDITORIA_MODELO_PRE_CLEANUP.md` para comparacion futura.
|
|
- Implementacion de ayuda visual en la zona de `Bootstrap` del playground.
|
|
- Añadidos tooltip y `aria-label` en `Cargar bootstrap`, `Reemplazar contexto`, `Vaciar contexto`, `Preset docs`, `Preset RAG docs` y `Preset codigo`.
|
|
- Actualizacion de `RAG/docs/PLAYGROUND.md` y `RAG/docs/TEXTOS_AYUDA_PLAYGROUND.md` para reflejar la mejora.
|
|
- Implementacion de la pestaña Limpieza en el playground y soporte en el backend (`POST /cleanup`) para borrado seguro de contextos ya ingeridos.
|
|
- Limpieza ejecutada exitosamente sobre el `scope` del código fuente antiguo (`RAG/src`).
|
|
- Reingesta del directorio `RAG/src` con el código actualizado.
|
|
- Documento de seguimiento `RAG/docs/TASK_LIMPIEZA.md` y documentacion API `RAG/docs/API_RAG.md` actualizados.
|
|
- Comparacion de auditorias del modelo (pre y post cleanup) documentada en `RAG/docs/TEMP_AUDITORIA_MODELO_PRE_CLEANUP.md`, confirmando una ganancia clara en nitidez y precision del RAG al evaluar el codigo.
|
|
- Implementacion de ingesta directa de carpetas locales desde el playground: el navegador empaqueta la carpeta en un `.zip` en memoria (filtrando `node_modules`, `dist`, `.git`, etc. con logica nativa) y el backend usa `adm-zip` para extraerla de forma segura en un directorio temporal antes de la ingesta.
|
|
- Correccion en `IngestService` (`resolveInputFiles` y `normalizeDocumentKey`) para escanear archivos desde la ruta temporal extraída (`readPath`) en lugar del identificador lógico al subir carpetas completas, evitando error de `ENOENT`.
|
|
- Revision inicial del corpus `/_imports/gstreamer-rag-text` como futura base documental especializada para GStreamer.
|
|
- Creacion de `RAG/docs/TASK_INGESTA_GSTREAMER.md` con el plan operativo para ingerirlo bajo un scope unico, validar retrieval y prepararlo para uso posterior con modelo local.
|
|
- Diagnostico y correccion del fallo real de ingesta masiva en corpus documentales: algunos ficheros generaban chunks sobredimensionados que acababan rompiendo la llamada a embeddings.
|
|
- Correccion aplicada en `src/modules/process/chunking.ts` y endurecimiento defensivo de `src/modules/embeddings/provider.ts`.
|
|
- Ingesta completada del corpus GStreamer bajo el scope unico `gstreamer-official` / `corpus:gstreamer:official:v1` con `3117` documentos y `22003` chunks.
|
|
- Validacion funcional en produccion mediante `GET /sources` y `POST /retrieve` para bootstrap y consulta especifica sobre request pads.
|
|
- Creacion y configuracion del agente primario `gstreamer` en OpenCode para diagnostico tecnico sobre proyectos con GStreamer, priorizando el scope `gstreamer-official` del RAG.
|
|
- Documentacion del agente en `RAG/docs/AGENTE_GSTREAMER.md`.
|
|
- Ajuste del agente `gstreamer` para asumir por defecto el scope `gstreamer-official` sin que el usuario tenga que mencionarlo expresamente en cada prompt.
|
|
- Creacion de un paquete portable para recrear el agente `gstreamer` en otro PC: `RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc` y `RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md`.
|
|
- Conexion operativa real del agente `gstreamer` al RAG remoto `https://rag.por-correo.com` mediante scripts dedicados fijados al scope `gstreamer-official`.
|
|
- Soporte explicito para flujos de `bootstrap` y `precarga` dirigida antes de revisar codigo.
|
|
- Ajuste del paquete portable del agente para usar placeholder `__IA_WORKSPACE_ROOT__` y poder reinstalarlo correctamente en otros equipos sin depender de rutas locales de este PC.
|
|
- Creacion de `RAG/agente_gstreamer/` como carpeta autocontenida para llevar el agente a otro PC con configuracion, scripts e instrucciones en un solo paquete.
|
|
|
|
---
|
|
|
|
### 2026-09-08 - Agente RAG 2
|
|
|
|
**Modelo:** gpt-5.6-sol
|
|
**Session ID OpenCode:** `ses_29bdbd003ffeLrLjUlFgnp08Y7`
|
|
**Directorio:** `/home/pancho/Documentos/Empresa/Desarrollo/IA/RAG`
|
|
|
|
**Trabajo realizado:**
|
|
- Auditoria de las 14 operaciones HTTP existentes y de sus contratos reales.
|
|
- Implementacion de `GET /help` y `GET /openapi.json`, dejando 16 operaciones documentadas.
|
|
- Creacion de un contrato OpenAPI 3.1.1 con esquemas, parametros, respuestas, errores y ejemplos.
|
|
- Reescritura de `docs/API_RAG.md` como guia operativa enlazada al contrato OpenAPI.
|
|
- Correccion del estado obsoleto de playground, logs, cleanup, stack y documentos de diseño.
|
|
- Correccion de la metodologia: local se limita a compilacion y comprobaciones estaticas; los flujos HTTP se validan tras publicar en produccion.
|
|
- Validacion satisfactoria con `npm run check`, `npm run build`, comprobacion de referencias OpenAPI y contraste automatico entre rutas implementadas y documentadas.
|
|
- Deteccion del build context obsoleto `/RAG` en EasyPanel tras la migracion del repositorio.
|
|
- Ajuste por el usuario de `Ruta de compilacion` a `/` y despliegue satisfactorio del commit `f1cd87c`.
|
|
- Validacion en produccion de health, Qdrant, playground, sources, `/help` y `/openapi.json`.
|
|
- Regresion satisfactoria de retrieval sobre FacturaTech: 6 resultados, cero fugas de scope y coincidencias `504` en los primeros resultados.
|
|
- Deteccion posterior de que `/help` enlazaba OpenAPI pero no explicaba para que debia consultarse.
|
|
- Incorporacion de una instruccion explicita en `/help` sobre parametros, cuerpos, respuestas, errores y ejemplos disponibles en `/openapi.json`.
|
|
|
|
**Estado final:**
|
|
- Ajuste final del pendiente 1 implementado y pendiente de revalidacion en `https://rag.por-correo.com`.
|
|
- La API dispone de descubrimiento rapido y contrato OpenAPI para sus 16 operaciones.
|