Guía de Pruebas - Base de Conocimiento RAG
🧪 Cómo Probar las Herramientas RAG
Ahora que las herramientas RAG están integradas en los modos Ask y Architect, puedes probarlas siguiendo estos pasos:
1. Instalar la Versión Actualizada
- Cierra VS Code
- Desinstala la versión anterior de Reasoning (si la hay)
- Instala la nueva versión:
ai-cockpit-reasoning-3.0.0-pre.1.vsix - Abre VS Code
2. Verificar que RAG está Inicializado
- Abre la consola de desarrollador de VS Code (F12)
- Busca este mensaje en la consola:
RAG Knowledge Base Manager started
3. Probar en Modo Ask
- Abre Reasoning
- Cambia al modo "Ask" (¡importante!)
- Prueba los siguientes comandos:
Prueba 1: Agregar Conocimiento
Agrega a la base de conocimiento: "React es una biblioteca de JavaScript para construir interfaces de usuario. Fue desarrollada por Facebook y permite crear componentes reutilizables."
Resultado esperado: Reasoning debería usar la herramienta add_rag_knowledge y confirmar que el elemento fue agregado.
Prueba 2: Buscar Conocimiento
Busca en la base de conocimiento información sobre React
Resultado esperado: Reasoning debería usar la herramienta search_rag_knowledge y devolver el elemento que fue agregado.
Prueba 3: Listar Conocimiento
Lista todos los elementos de la base de conocimiento
Resultado esperado: Reasoning debería usar la herramienta list_rag_knowledge y mostrar todos los elementos.
Prueba 4: Obtener Estadísticas
Muestra las estadísticas de la base de conocimiento
Resultado esperado: Reasoning debería usar la herramienta get_rag_stats y mostrar las estadísticas.
4. Probar en Modo Architect
- Cambia al modo "Architect"
- Prueba el mismo comando:
Agrega a la base de conocimiento: "TypeScript es un superconjunto de JavaScript que agrega tipado estático. Fue desarrollado por Microsoft."
5. Verificar que no funciona en otros modos
- Cambia al modo "Code"
- Intenta el mismo comando:
Agrega a la base de conocimiento: "Prueba"
Resultado esperado: Reasoning debería crear un archivo MD en el proyecto (comportamiento anterior), ya que el modo "Code" no tiene acceso a las herramientas RAG.
6. Verificar los Datos Guardados
Los datos se guardan en:
- macOS:
~/Library/Application Support/Code/User/globalStorage/roo-code.ai-cockpit-reasoning/knowledge-base/knowledge-base.json
Verifica si el archivo fue creado y contiene los datos agregados.
7. Solución de Problemas
Si las herramientas no aparecen:
- Asegúrate de estar en el modo "Ask" o "Architect"
- Verifica la consola en busca de errores
- Reinicia VS Code
Si RAG no se inicializa:
- Verifica el mensaje "RAG Knowledge Base Manager started" en la consola
- Si no aparece, puede haber un error de inicialización
Si los datos no persisten:
- Verifica los permisos del directorio de datos
- Verifica el espacio disponible en disco
8. Ejemplos de Uso en el Mundo Real
Agregar Documentación del Proyecto:
Agrega a la base de conocimiento: "Este proyecto usa React 18 con TypeScript. La estructura de carpetas sigue el patrón src/components, src/hooks, src/utils. El estado global se gestiona con Zustand."
Agregar Fragmentos de Código:
Agrega a la base de conocimiento: "Para crear un hook personalizado en React: const useCustomHook = () => { const [state, setState] = useState(); return { state, setState }; };"
Buscar Soluciones:
Busca en la base de conocimiento soluciones a problemas de estado en React