Paco POR-CORREO
b9a37f27c9
- RAG/ subfolder content promoted to repo root (git detected as renames) - Remove parent-level docs/ and .gitignore from tracking (not part of RAG project) - Add .atl/ to .gitignore (local agent caches) - No history rewrite; prior commits preserved as-is
181 lines
4.2 KiB
Markdown
181 lines
4.2 KiB
Markdown
# 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.).
|