rag-service/RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md

4.2 KiB

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:

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:

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:

__IA_WORKSPACE_ROOT__

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

Ejemplo:

__IA_WORKSPACE_ROOT__

por:

/home/usuario/Documentos/Empresa/Desarrollo/IA

Los scripts deben quedar accesibles en esa ruta final:

<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:

~/.config/opencode/opencode.jsonc

3. Insertar el agente

Pegar el bloque dentro de la clave raiz agent.

Si no existe agent, crearla.

Ejemplo:

{
  "$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:

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:

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:

usa el rag para revisar el codigo del fichero nombrefichero.cpp
diagnostica este error de gstreamer en mi modulo C++ y propon cambios, sin aplicarlos todavia
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.).