Add portable GStreamer agent installation files

This commit is contained in:
Paco POR-CORREO 2026-04-09 18:51:20 +02:00
parent 46daa9977e
commit 27262f6a85
5 changed files with 202 additions and 1 deletions

View file

@ -0,0 +1,17 @@
{
"agent": {
"gstreamer": {
"description": "Agente primario especializado en GStreamer con apoyo prioritario del RAG del scope gstreamer-official para diagnostico y propuesta de correcciones en proyectos C++.",
"mode": "primary",
"color": "info",
"steps": 20,
"permission": {
"question": "allow",
"plan_enter": "allow",
"webfetch": "deny",
"websearch": "deny"
},
"prompt": "Eres el agente gstreamer del workspace. Tu especialidad es diagnosticar, revisar y proponer correcciones en proyectos que usan GStreamer, con foco principal en C++. Debes priorizar siempre la informacion recuperada desde el RAG del scope `gstreamer-official` (`sourceId`: `corpus:gstreamer:official:v1`, `sourceRef`: `gstreamer-official`). Usa tu conocimiento interno solo como apoyo cuando ayude, pero intenta anclar tus diagnosticos y propuestas en la documentacion del RAG siempre que sea posible. No dependas de Internet ni salgas a la web.\n\nRegla operativa principal:\n- Si el usuario te pide revisar codigo, diagnosticar errores, explicar comportamiento de GStreamer, proponer correcciones o \"usar el RAG\", debes asumir automaticamente que el corpus a consultar es `gstreamer-official`, aunque el usuario no mencione el scope.\n- No hace falta que el usuario te diga el nombre del scope. Tu scope por defecto y permanente es `gstreamer-official`, salvo que en el futuro se reconfigure expresamente.\n- Trata frases como \"usa el RAG para revisar este fichero\", \"revisa este codigo con apoyo del RAG\" o \"diagnostica este error\" como una instruccion suficiente para apoyarte en el RAG de GStreamer.\n\nComportamiento esperado:\n- Por defecto diagnostica y propone cambios; no edites archivos ni apliques fixes salvo que el usuario lo pida explicitamente.\n- Cuando revises codigo, busca errores de integracion, estados, pads, caps, bus messages, linking, negotiation, hilos, lifecycle, pipeline design y uso de APIs de GStreamer.\n- Antes de emitir un diagnostico fuerte, intenta apoyarte en contexto util del RAG de GStreamer. Si el problema es amplio, prioriza una vision bootstrap del dominio; si es concreto, prioriza recuperar documentacion especifica relacionada con el fallo.\n- Si propones cambios, explica por que, que problema corrigen y que riesgo introducen.\n- Si el usuario te pide aplicar cambios, entonces puedes editar, compilar, ejecutar comandos, lanzar pruebas y validar si el problema parece resuelto.\n- Para proyectos grandes, pide o selecciona modulos, ficheros, logs y sintomas concretos en lugar de revisar todo de golpe.\n- Si el RAG no aporta evidencia suficiente, dilo explicitamente.\n- Cuando trabajes con codigo, asume inicialmente C++ como lenguaje principal, aunque puedes razonar sobre otros lenguajes si aparecen.\n\nObjetivo: servir como agente tecnico especializado en GStreamer para diagnostico, propuesta de parches y validacion posterior de correcciones apoyandote sobre todo en el corpus documental oficial cargado en el RAG."
}
}
}

View file

@ -59,3 +59,4 @@ Dar continuidad al RAG en `RAG/` a partir del estado actual documentado.
- 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`.

View file

@ -0,0 +1,148 @@
# Instalar Agente GStreamer En Otro PC
**Proyecto:** Workspace de tools IA para empresas
**Modulo:** RAG
**Ultima actualizacion:** 2026-04-09
**Ultima modificacion por:** Agente RAG 2
**Estado:** Activo
---
## Proposito
Dejar un procedimiento portable para recrear el agente `gstreamer` en otro PC que use OpenCode.
Este paquete reproduce el comportamiento actual del agente:
- agente primario seleccionable con `Tab`
- especializado en GStreamer
- orientado a C++
- por defecto diagnostica y propone, no modifica
- asume el scope `gstreamer-official` como base RAG por defecto
---
## Archivos necesarios
1. `RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc`
2. `RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md`
---
## Importante
Este agente **no queda cableado tecnicamente** al endpoint remoto `https://rag.por-correo.com` solo por copiar este fichero.
Lo que si queda replicado es:
- su prompt
- su comportamiento
- su scope RAG por defecto asumido (`gstreamer-official`)
Eso significa que en el otro PC el agente quedara operativo del mismo modo que aqui, pero su uso del RAG seguira siendo una convencion de comportamiento del agente, no una integracion dura por herramienta o MCP.
Si en el futuro se quiere conexion automatica real al RAG remoto, habra que añadir esa integracion aparte.
---
## Instalacion manual
### 1. Copiar el bloque del agente
Abrir este archivo:
```text
RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc
```
Y copiar su contenido.
### 2. Abrir la configuracion de OpenCode en el otro PC
Ruta habitual:
```text
~/.config/opencode/opencode.jsonc
```
### 3. Insertar el agente
Pegar el bloque dentro de la clave raiz `agent`.
Si no existe `agent`, crearla.
Ejemplo:
```jsonc
{
"$schema": "https://opencode.ai/config.json",
"agent": {
"gstreamer": {
...
}
}
}
```
### 4. Reiniciar OpenCode
Cerrar la sesion o reiniciar OpenCode para que recargue la configuracion.
### 5. Verificar
Al pulsar `Tab`, debe aparecer el agente:
```text
gstreamer
```
---
## Instalacion asistida por otro agente OpenCode
Si en el otro PC quieres que otro agente te lo deje instalado automaticamente, dale estos dos archivos y usa un prompt como este:
```text
Lee estos dos archivos:
- RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc
- RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md
Instala el agente `gstreamer` en mi configuracion local de OpenCode, dejandolo disponible como agente primario seleccionable con Tab.
No cambies otros agentes existentes.
Cuando termines, comprueba que la configuracion queda valida y dime si tengo que reiniciar OpenCode.
```
---
## Comprobacion minima de uso
Una vez instalado, prueba prompts de este estilo:
```text
usa el rag para revisar el codigo del fichero nombrefichero.cpp
```
```text
diagnostica este error de gstreamer en mi modulo C++ y propon cambios, sin aplicarlos todavia
```
```text
revisa este fichero con apoyo del rag y dime si hay problemas de pads, caps o estados
```
---
## Limitaciones actuales
1. El agente asume el scope `gstreamer-official` por prompt, no por integracion dura.
2. No cambia automaticamente de scope.
3. No aplica cambios salvo que el usuario lo pida.
4. No usa web ni fuentes externas.
---
## Evolucion futura recomendada
1. Integracion real con el RAG remoto `rag.por-correo.com`.
2. Seleccion dinamica de scopes disponibles.
3. Prompt afinado por modelo local (`gemma4`, `qwen3.5`, etc.).

View file

@ -107,6 +107,7 @@ Este archivo registra agentes y sesiones de trabajo de este workspace.
- 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`.
- Preparacion de ficheros portables para reinstalar el agente `gstreamer` en otro PC con OpenCode.
#### Estado final:
- `Agente RAG 2` registrado en el historial global del workspace.

View file

@ -357,6 +357,40 @@ Documentar el agente `gstreamer` de OpenCode, su scope documental por defecto, s
---
### `RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc`
**Ubicacion:** `RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc`
**Proposito:**
Bloque portable de configuracion del agente `gstreamer` para instalarlo en otra instancia de OpenCode.
**Cuando leerlo:**
- al querer replicar el agente `gstreamer` en otro PC
- al necesitar copiar exactamente su configuracion de OpenCode
**Cuando actualizarlo:**
- cuando cambie el prompt o comportamiento efectivo del agente
- cuando cambie la configuracion de permisos o modo del agente
---
### `RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md`
**Ubicacion:** `RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md`
**Proposito:**
Explicar como instalar el agente `gstreamer` en otro PC, tanto manualmente como usando otro agente OpenCode.
**Cuando leerlo:**
- al migrar el agente `gstreamer` a otro equipo
- al querer reinstalarlo o automatizar su despliegue local
**Cuando actualizarlo:**
- cuando cambie el proceso de instalacion del agente
- cuando se añada una integracion real con el RAG remoto
---
### `sesion_actual_opencode.md`
**Ubicacion:** `docs/sesion_actual_opencode.md`
@ -383,4 +417,4 @@ Instruccion universal para detectar la sesion activa de OpenCode del workspace a
## Estadistica global
**Total de documentos indexados:** 20
**Total de documentos indexados:** 22