From 428acf1a6f0f1dc9b4609d18e4f62d96cd53f95e Mon Sep 17 00:00:00 2001 From: Paco POR-CORREO Date: Thu, 9 Apr 2026 18:29:10 +0200 Subject: [PATCH] Document OpenCode GStreamer agent configuration --- RAG/docs/AGENTE_GSTREAMER.md | 135 +++++++++++++++++++++++++++++++++ RAG/docs/HISTORIAL_SESIONES.md | 2 + docs/HISTORIAL_SESIONES.md | 32 ++++++++ docs/INDICE_DOCUMENTACION.md | 36 ++++++++- 4 files changed, 204 insertions(+), 1 deletion(-) create mode 100644 RAG/docs/AGENTE_GSTREAMER.md diff --git a/RAG/docs/AGENTE_GSTREAMER.md b/RAG/docs/AGENTE_GSTREAMER.md new file mode 100644 index 0000000..4a89f6a --- /dev/null +++ b/RAG/docs/AGENTE_GSTREAMER.md @@ -0,0 +1,135 @@ +# Agente GStreamer + +**Proyecto:** Workspace de tools IA para empresas +**Modulo:** RAG +**Ultima actualizacion:** 2026-04-09 +**Ultima modificacion por:** Agente RAG 2 +**Estado:** Activo + +--- + +## Proposito + +Documentar el agente `gstreamer` configurado en OpenCode para trabajo tecnico especializado sobre proyectos que usan GStreamer. + +El objetivo del agente no es ser un asistente generalista, sino un agente operativo para: + +- revisar codigo +- diagnosticar errores +- proponer correcciones +- y, solo si se le pide, aplicar y validar cambios + +apoyandose de forma prioritaria en el RAG del corpus oficial de GStreamer. + +--- + +## Nombre del agente + +```text +gstreamer +``` + +Debe aparecer como agente primario seleccionable junto con otros modos primarios del entorno OpenCode. + +--- + +## Base de conocimiento principal + +El agente debe priorizar siempre el scope del RAG cargado para GStreamer: + +- `sourceId`: `corpus:gstreamer:official:v1` +- `sourceRef`: `gstreamer-official` + +Este scope contiene la documentacion oficial de GStreamer ya ingerida y validada. + +Regla operativa: + +- primero apoyarse en el RAG de GStreamer +- despues complementar con conocimiento interno del modelo cuando ayude +- no depender de busquedas web + +--- + +## Enfoque tecnico del agente + +### Dominio principal + +- GStreamer +- integracion en aplicaciones reales +- diagnostico de pipelines +- uso de elementos, pads, caps, states, bus, negotiation y ciclo de vida + +### Lenguaje principal esperado + +- C++ + +Aunque puede trabajar con otros lenguajes si aparecen, su orientacion principal debe ser revision tecnica de codigo C++ que integre GStreamer. + +--- + +## Comportamiento esperado + +### Por defecto + +El agente debe: + +- diagnosticar +- explicar el problema +- proponer cambios +- justificar los cambios propuestos + +### No debe hacer por defecto + +- editar ficheros automaticamente +- aplicar fixes sin permiso +- modificar codigo solo por detectar un posible error + +### Si el usuario lo pide explicitamente + +Entonces si puede: + +- editar ficheros +- compilar +- ejecutar comandos +- lanzar pruebas +- validar si el error parece resuelto + +--- + +## Forma recomendada de uso + +El agente funciona mejor cuando recibe: + +- ficheros o modulos concretos +- sintomas observados +- logs de error +- mensajes del bus de GStreamer +- comportamiento esperado frente al comportamiento real + +No conviene pedirle que revise una aplicacion enorme de una sola vez sin contexto adicional. + +--- + +## Restricciones intencionadas + +En la configuracion actual del agente: + +- `webfetch`: denegado +- `websearch`: denegado + +Asi se fuerza que el agente se apoye sobre todo en: + +- el RAG de GStreamer +- el codigo local +- el conocimiento interno del modelo + +--- + +## Evolucion futura prevista + +Posibles mejoras futuras: + +1. Permitir cambiar de scope entre varios corpus del mismo RAG. +2. Hacer visible la eleccion de scope desde el propio agente. +3. Ajustar el agente a flujos de prueba automatizada del proyecto donde se use GStreamer. +4. Afinar su prompt segun comportamiento real con modelos locales como `gemma4` o `qwen3.5`. diff --git a/RAG/docs/HISTORIAL_SESIONES.md b/RAG/docs/HISTORIAL_SESIONES.md index 4e2898a..0776dd0 100644 --- a/RAG/docs/HISTORIAL_SESIONES.md +++ b/RAG/docs/HISTORIAL_SESIONES.md @@ -56,3 +56,5 @@ Dar continuidad al RAG en `RAG/` a partir del estado actual documentado. - 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`. diff --git a/docs/HISTORIAL_SESIONES.md b/docs/HISTORIAL_SESIONES.md index c7b82d9..9cfdd24 100644 --- a/docs/HISTORIAL_SESIONES.md +++ b/docs/HISTORIAL_SESIONES.md @@ -11,6 +11,7 @@ Este archivo registra agentes y sesiones de trabajo de este workspace. | Agente | Responsabilidad | Identificador | |--------|-----------------|---------------| | **Agente tools IA para potenciar servicios empresariales** | Desarrollo de tools, herramientas, skills, RAGs, MCPs y utilidades para potenciar soluciones con IA para empresas | `session_id OpenCode por workspace cuando aplique` | +| **Agente RAG 2** | Continuidad operativa y evolutiva del modulo `RAG/`, incluyendo codigo, pruebas y documentacion del servicio | `ses_29bdbd003ffeLrLjUlFgnp08Y7` | --- @@ -69,6 +70,8 @@ Este archivo registra agentes y sesiones de trabajo de este workspace. - Implementacion de logs de evaluacion persistentes en `Qdrant`, con disparo automatico por contexto insuficiente y registro manual con nota desde el playground. - Ampliacion de los logs de evaluacion para permitir seguimiento real (`pending`, `resolved`, `ignored`, etc.) y documentacion de su arquitectura en `RAG/docs/LOGS_EVALUACION.md`. - Ajuste visual del playground con branding de POR-CORREO, nuevo titulo y contador visible de logs para detectar de un vistazo actividad de evaluacion. +- Creacion de `RAG/docs/METODOLOGIA_ITERACION_Y_REDEPLOY.md` para dejar explicito el flujo ya validado de implementacion, prueba local, commit, push y redeploy en EasyPanel. +- Creacion de `RAG/docs/TEXTOS_AYUDA_PLAYGROUND.md` y nueva task asociada para que otro agente implemente ayuda visual y textos ALT en los botones principales del playground. - Reorganizacion de RAG como modulo raiz independiente con documentacion propia en `RAG/docs/`. - Ajuste del indice documental global para reflejar la separacion entre documentacion global y documentacion por tool. - Creacion de `docs/TASK.md` para descomponer lineas de trabajo amplias en puntos de analisis y acuerdos. @@ -88,9 +91,38 @@ Este archivo registra agentes y sesiones de trabajo de este workspace. --- +### Sesion 2 (2026-04-06) - Agente RAG 2 +**Agente:** **Agente RAG 2** +**Modelo:** gpt-5.4 +**Conversation ID:** `N/D (OpenCode no lo expone en este entorno)` +**Session ID OpenCode:** `ses_29bdbd003ffeLrLjUlFgnp08Y7` +**Titulo de sesion:** `Continuación de proyecto Agente RAG 2` +**Directorio:** `/home/pancho/Documentos/Empresa/Desarrollo/IA` + +#### Trabajo realizado: +- Lectura del `docs/README.md` global del workspace para alinear reglas de documentacion y registro. +- Revision de `docs/HISTORIAL_SESIONES.md` y `docs/sesion_actual_opencode.md` como base operativa de continuidad. +- Revision inicial de la documentacion principal del modulo `RAG/` para retomar el estado de la v1. +- Registro de continuidad como `Agente RAG 2` orientado especificamente al trabajo sobre `RAG/`. +- Creacion de `RAG/docs/HISTORIAL_SESIONES.md` como historial interno del modulo para trazabilidad local entre sesiones del propio RAG. +- Configuracion del agente primario `gstreamer` en OpenCode para trabajo especializado con el RAG de GStreamer. +- Indexacion y documentacion del comportamiento del agente `gstreamer`. + +#### Estado final: +- `Agente RAG 2` registrado en el historial global del workspace. +- Contexto global del workspace alineado con el contexto especifico de `RAG/`. +- Sesion actual identificada con su `session_id` real de OpenCode. + +--- + ## Agentes activos ### Agente tools IA para potenciar servicios empresariales - **Responsabilidad:** Desarrollo de tools, herramientas, skills, RAGs, MCPs y utilidades para potenciar soluciones con IA para empresas. - **Estado:** Activo - **Trabajo principal:** Desarrollo de herramientas reutilizables e integraciones para potenciar otros servicios de IA empresariales. + +### Agente RAG 2 +- **Responsabilidad:** Continuidad operativa y evolutiva del modulo `RAG/`, incluyendo backend, playground, retrieval, answer, logs y documentacion del servicio. +- **Estado:** Activo +- **Trabajo principal:** Retomar y hacer avanzar el proyecto `RAG/` sin perder continuidad entre sesiones. diff --git a/docs/INDICE_DOCUMENTACION.md b/docs/INDICE_DOCUMENTACION.md index 7c3cea0..1ae5a61 100644 --- a/docs/INDICE_DOCUMENTACION.md +++ b/docs/INDICE_DOCUMENTACION.md @@ -323,6 +323,40 @@ Documentar como se guardan, siguen y revisan los logs de evaluacion del RAG. --- +### `RAG/docs/METODOLOGIA_ITERACION_Y_REDEPLOY.md` + +**Ubicacion:** `RAG/docs/METODOLOGIA_ITERACION_Y_REDEPLOY.md` + +**Proposito:** +Documentar la metodologia de trabajo ya validada para implementar, probar, subir y redeplegar mejoras del RAG sin reinventar el flujo en cada sesion. + +**Cuando leerlo:** +- al continuar el trabajo del RAG desde una nueva sesion +- al necesitar saber cuando un cambio ya esta listo para pedir `Deploy` al usuario + +**Cuando actualizarlo:** +- cuando cambie el flujo operativo de iteracion, validacion o despliegue +- cuando se detecte una mejora estable en la metodologia de trabajo + +--- + +### `RAG/docs/AGENTE_GSTREAMER.md` + +**Ubicacion:** `RAG/docs/AGENTE_GSTREAMER.md` + +**Proposito:** +Documentar el agente `gstreamer` de OpenCode, su scope documental por defecto, su comportamiento esperado y su orientacion a diagnostico tecnico sobre proyectos con GStreamer. + +**Cuando leerlo:** +- al usar o ajustar el agente `gstreamer` +- al revisar como debe apoyarse en el RAG de GStreamer y como debe comportarse frente a cambios de codigo + +**Cuando actualizarlo:** +- cuando cambie el prompt o el comportamiento del agente +- cuando se amplie para soportar cambio dinamico de scope u otros corpus del RAG + +--- + ### `sesion_actual_opencode.md` **Ubicacion:** `docs/sesion_actual_opencode.md` @@ -349,4 +383,4 @@ Instruccion universal para detectar la sesion activa de OpenCode del workspace a ## Estadistica global -**Total de documentos indexados:** 18 +**Total de documentos indexados:** 20