Pular para o conteúdo principal

Guia de Testes - Base de Conhecimento RAG

🧪 Como Testar as Ferramentas RAG​

Agora que as ferramentas RAG estão integradas aos modos Ask e Architect, você pode testá-las seguindo estes passos:

1. Instale a Versão Atualizada​

  1. Feche o VS Code
  2. Desinstale a versão anterior do Reasoning (se houver)
  3. Instale a nova versão: ai-cockpit-reasoning-3.0.0-pre.1.vsix
  4. Abra o VS Code

2. Verifique se o RAG foi Inicializado​

  1. Abra o console de desenvolvedor do VS Code (F12)
  2. Procure por esta mensagem no console: 
    RAG Knowledge Base Manager started

3. Teste no Modo Ask​

  1. Abra o Reasoning
  2. Mude para o modo "Ask" (importante!)
  3. Teste os seguintes comandos:

Teste 1: Adicionar Conhecimento​

Adicione à base de conhecimento: "React é uma biblioteca JavaScript para construir interfaces de usuário. Foi desenvolvida pelo Facebook e permite criar componentes reutilizáveis."

Resultado esperado: O Reasoning deve usar a ferramenta add_rag_knowledge e confirmar que o item foi adicionado.

Teste 2: Pesquisar Conhecimento​

Pesquise na base de conhecimento por informações sobre React

Resultado esperado: O Reasoning deve usar a ferramenta search_rag_knowledge e retornar o item que foi adicionado.

Teste 3: Listar Conhecimento​

Liste todos os itens da base de conhecimento

Resultado esperado: O Reasoning deve usar a ferramenta list_rag_knowledge e mostrar todos os itens.

Teste 4: Obter Estatísticas​

Mostre as estatísticas da base de conhecimento

Resultado esperado: O Reasoning deve usar a ferramenta get_rag_stats e exibir as estatísticas.

4. Teste no Modo Architect​

  1. Mude para o modo "Architect"
  2. Teste o mesmo comando: 
    Adicione à base de conhecimento: "TypeScript é um superconjunto de JavaScript que adiciona tipagem estática. Foi desenvolvido pela Microsoft."

5. Verifique se não funciona em outros modos​

  1. Mude para o modo "Code"
  2. Tente o mesmo comando: 
    Adicione à base de conhecimento: "Teste"

Resultado esperado: O Reasoning deve criar um arquivo MD no projeto (comportamento antigo), pois o modo "Code" não tem acesso às ferramentas RAG.

6. Verifique os Dados Salvos​

Os dados são salvos em:

  • macOS: ~/Library/Application Support/Code/User/globalStorage/roo-code.ai-cockpit-reasoning/knowledge-base/knowledge-base.json

Verifique se o arquivo foi criado e contém os dados adicionados.

7. Solução de Problemas​

Se as ferramentas não aparecerem:​

  1. Certifique-se de que você está no modo "Ask" ou "Architect"
  2. Verifique o console em busca de erros
  3. Reinicie o VS Code

Se o RAG não inicializar:​

  1. Verifique no console a mensagem "RAG Knowledge Base Manager started"
  2. Se não aparecer, pode haver um erro de inicialização

Se os dados não persistirem:​

  1. Verifique as permissões do diretório de dados
  2. Verifique o espaço em disco disponível

8. Exemplos de Uso no Mundo Real​

Adicionar Documentação do Projeto:​

Adicione à base de conhecimento: "Este projeto usa React 18 com TypeScript. A estrutura de pastas segue o padrão src/components, src/hooks, src/utils. O estado global é gerenciado com Zustand."

Adicionar Trechos de Código:​

Adicione à base de conhecimento: "Para criar um hook personalizado no React: const useCustomHook = () => { const [state, setState] = useState(); return { state, setState }; };"

Pesquisar por Soluções:​

Pesquise na base de conhecimento por soluções para problemas de estado no React