Add portable GStreamer agent installation files
This commit is contained in:
parent
46daa9977e
commit
27262f6a85
5 changed files with 202 additions and 1 deletions
17
RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc
Normal file
17
RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc
Normal 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."
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -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`.
|
||||
|
|
|
|||
148
RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md
Normal file
148
RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md
Normal 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.).
|
||||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue