rag-service/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md

# 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
- queda conectado operativamente al RAG remoto mediante scripts locales

---

## Archivos necesarios

1. `RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc`
2. `RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md`
3. `RAG/scripts/rag_gstreamer_bootstrap.sh`
4. `RAG/scripts/rag_gstreamer_retrieve.sh`

---

## Importante

Este agente queda conectado operativamente al endpoint remoto `https://rag.por-correo.com` si copias tambien los dos scripts de `RAG/scripts/` al otro PC y respetas sus rutas o las adaptas en el prompt.

---

## Instalacion manual

### 1. Copiar el bloque del agente

Abrir este archivo:

```text
RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc
```

Y copiar su contenido.

### 1.b Copiar los scripts de conexion al RAG

Copiar tambien estos dos scripts al otro PC:

```text
RAG/scripts/rag_gstreamer_bootstrap.sh
RAG/scripts/rag_gstreamer_retrieve.sh
```

### 1.c Sustituir el placeholder de ruta

En `RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc` aparece este marcador:

```text
__IA_WORKSPACE_ROOT__
```

Antes de instalar el agente en el otro PC, sustituyelo por la ruta absoluta real del workspace en ese equipo.

Ejemplo:

```text
__IA_WORKSPACE_ROOT__
```

por:

```text
/home/usuario/Documentos/Empresa/Desarrollo/IA
```

Los scripts deben quedar accesibles en esa ruta final:

```text
<workspace>/RAG/scripts/rag_gstreamer_bootstrap.sh
<workspace>/RAG/scripts/rag_gstreamer_retrieve.sh
```

### 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.
Tambien instala y deja ejecutables los scripts `RAG/scripts/rag_gstreamer_bootstrap.sh` y `RAG/scripts/rag_gstreamer_retrieve.sh`, manteniendo o ajustando sus rutas para que el prompt del agente los pueda usar.
Sustituye tambien el placeholder `__IA_WORKSPACE_ROOT__` por la ruta absoluta real del workspace en este PC dentro del fichero de configuracion portable.
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. La integracion actual se hace por scripts locales + prompt del agente, no por MCP nativo.
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.).