184 lines
3.7 KiB
Markdown
184 lines
3.7 KiB
Markdown
# Instalar Agente GStreamer En Otro PC
|
|
|
|
**Proyecto:** Workspace de tools IA para empresas
|
|
**Modulo:** RAG
|
|
**Paquete portable:** `RAG/agente_gstreamer/`
|
|
|
|
---
|
|
|
|
## Que debes llevarte
|
|
|
|
Llevate la carpeta completa:
|
|
|
|
```text
|
|
RAG/agente_gstreamer/
|
|
```
|
|
|
|
Contiene todo lo necesario para recrear el agente:
|
|
|
|
1. `AGENTE_GSTREAMER_OPENCODE.jsonc`
|
|
2. `rag_gstreamer_bootstrap.sh`
|
|
3. `rag_gstreamer_retrieve.sh`
|
|
4. `INSTALAR_EN_OTRO_PC.md`
|
|
|
|
---
|
|
|
|
## Que hace este paquete
|
|
|
|
Deja instalado un agente `gstreamer` en OpenCode que:
|
|
|
|
- aparece como agente primario al cambiar con `Tab`
|
|
- esta enfocado en GStreamer y C++
|
|
- diagnostica y propone cambios por defecto
|
|
- no modifica codigo salvo que se le pida expresamente
|
|
- queda conectado operativamente al RAG remoto `https://rag.por-correo.com`
|
|
- usa por defecto el scope:
|
|
- `sourceId`: `corpus:gstreamer:official:v1`
|
|
- `sourceRef`: `gstreamer-official`
|
|
|
|
---
|
|
|
|
## Paso 1. Copiar la carpeta al otro PC
|
|
|
|
Coloca esta carpeta dentro del workspace del otro PC.
|
|
|
|
Ejemplo:
|
|
|
|
```text
|
|
/home/usuario/Documentos/Empresa/Desarrollo/IA/RAG/agente_gstreamer/
|
|
```
|
|
|
|
---
|
|
|
|
## Paso 2. Sustituir el placeholder de ruta
|
|
|
|
Abre:
|
|
|
|
```text
|
|
RAG/agente_gstreamer/AGENTE_GSTREAMER_OPENCODE.jsonc
|
|
```
|
|
|
|
Y sustituye:
|
|
|
|
```text
|
|
__IA_WORKSPACE_ROOT__
|
|
```
|
|
|
|
por la ruta absoluta real del workspace en ese otro PC.
|
|
|
|
Ejemplo:
|
|
|
|
```text
|
|
/home/usuario/Documentos/Empresa/Desarrollo/IA
|
|
```
|
|
|
|
Esto es importante porque el agente llamara a estos scripts por ruta absoluta:
|
|
|
|
```text
|
|
<workspace>/RAG/agente_gstreamer/rag_gstreamer_bootstrap.sh
|
|
<workspace>/RAG/agente_gstreamer/rag_gstreamer_retrieve.sh
|
|
```
|
|
|
|
---
|
|
|
|
## Paso 3. Dejar ejecutables los scripts
|
|
|
|
En el otro PC ejecuta:
|
|
|
|
```bash
|
|
chmod +x RAG/agente_gstreamer/rag_gstreamer_bootstrap.sh
|
|
chmod +x RAG/agente_gstreamer/rag_gstreamer_retrieve.sh
|
|
```
|
|
|
|
---
|
|
|
|
## Paso 4. Instalar el agente en OpenCode
|
|
|
|
Abre la configuracion de OpenCode del otro PC:
|
|
|
|
```text
|
|
~/.config/opencode/opencode.jsonc
|
|
```
|
|
|
|
Luego copia el bloque del archivo:
|
|
|
|
```text
|
|
RAG/agente_gstreamer/AGENTE_GSTREAMER_OPENCODE.jsonc
|
|
```
|
|
|
|
y pegalo dentro de la clave raiz `agent`.
|
|
|
|
Si no existe `agent`, creala.
|
|
|
|
Ejemplo:
|
|
|
|
```jsonc
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"agent": {
|
|
"gstreamer": {
|
|
...
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Paso 5. Reiniciar OpenCode
|
|
|
|
Cierra la sesion actual o reinicia OpenCode para que recargue la configuracion.
|
|
|
|
Despues, al pulsar `Tab`, debe aparecer:
|
|
|
|
```text
|
|
gstreamer
|
|
```
|
|
|
|
---
|
|
|
|
## Instalacion asistida por otro agente OpenCode
|
|
|
|
Si quieres que el OpenCode del otro PC lo instale por ti, dale esta instruccion:
|
|
|
|
```text
|
|
Lee estos archivos dentro de `RAG/agente_gstreamer/`:
|
|
- AGENTE_GSTREAMER_OPENCODE.jsonc
|
|
- INSTALAR_EN_OTRO_PC.md
|
|
|
|
Instala el agente `gstreamer` en mi configuracion local de OpenCode.
|
|
|
|
Requisitos:
|
|
1. Sustituye `__IA_WORKSPACE_ROOT__` por la ruta absoluta real de este workspace.
|
|
2. No cambies otros agentes existentes.
|
|
3. Deja ejecutables estos scripts:
|
|
- RAG/agente_gstreamer/rag_gstreamer_bootstrap.sh
|
|
- RAG/agente_gstreamer/rag_gstreamer_retrieve.sh
|
|
4. Inserta el agente dentro de `~/.config/opencode/opencode.jsonc`.
|
|
5. Dime al final si necesito reiniciar OpenCode.
|
|
```
|
|
|
|
---
|
|
|
|
## Ejemplos de uso despues de instalarlo
|
|
|
|
```text
|
|
usa el rag para revisar el codigo del fichero nombrefichero.cpp
|
|
```
|
|
|
|
```text
|
|
revisa este codigo y apoyate en el rag haciendo una precarga sobre uso especifico de video remoto
|
|
```
|
|
|
|
```text
|
|
diagnostica este error de gstreamer en este modulo C++ y propon cambios, sin aplicarlos todavia
|
|
```
|
|
|
|
---
|
|
|
|
## Notas importantes
|
|
|
|
1. Este paquete ya deja al agente conectado operativamente al RAG remoto.
|
|
2. La integracion se hace por scripts locales + prompt del agente, no por MCP nativo.
|
|
3. El scope por defecto sigue siendo `gstreamer-official`.
|
|
4. Si en el futuro cambias el endpoint del RAG o el scope, habra que actualizar este paquete.
|