Meu Chat Groq

Assistente inteligente para análise de código dentro do Visual Studio Code utilizando a API da Groq.

O diferencial desta extensão é o processo de análise baseado em múltiplos agentes de inteligência artificial. Em vez de receber apenas uma resposta, o código é avaliado por dois agentes independentes e um terceiro agente atua como juiz técnico para selecionar a melhor análise final.

---

Sumário

• Visão Geral
• Como Funciona
• Requisitos
• Instalação
• Criando uma Chave da API Groq
• Configurando a API no VS Code
• Como Utilizar
• Processo de Análise
• Boas Práticas
• Solução de Problemas
• Privacidade
• Changelog

---

Visão Geral

O Meu Chat Groq foi criado para auxiliar desenvolvedores na revisão de código-fonte diretamente no Visual Studio Code.

A extensão permite:

• Revisão de código
• Identificação de bugs
• Sugestões de melhorias
• Verificação de boas práticas
• Avaliação de legibilidade
• Recomendações de performance
• Explicações técnicas detalhadas

---

Como Funciona

A análise acontece em três etapas:

Agente 1

O primeiro agente analisa o código de forma independente e gera uma avaliação técnica.

Agente 2

O segundo agente realiza uma análise separada, podendo encontrar problemas e oportunidades diferentes.

Agente Judge

Um terceiro agente especializado atua como avaliador.

Sua função é:

• Comparar as respostas dos dois agentes
• Identificar inconsistências
• Avaliar qualidade técnica
• Selecionar a melhor resposta
• Entregar o resultado final ao usuário

Esse processo reduz respostas superficiais e aumenta a qualidade da análise entregue.

---

Requisitos

Antes de utilizar a extensão você precisa possuir:

• Visual Studio Code instalado
• Conta na Groq
• Chave de API da Groq válida
• Conexão com a internet

---

Instalação

Pelo Marketplace

1. Abra o Visual Studio Code
2. Acesse a aba Extensions
3. Pesquise por "Meu Chat Groq"
4. Clique em Install

---

Criando uma Chave da API Groq

A extensão utiliza os modelos de IA fornecidos pela Groq.

Passo 1

Acesse:

https://console.groq.com

Passo 2

Crie uma conta ou faça login.

Passo 3

No painel principal, localize a seção:

API Keys

Passo 4

Clique em:

Create API Key

Passo 5

Dê um nome para a chave.

Exemplo:

VSCode

Passo 6

Copie a chave gerada.

Exemplo:

gsk_xxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ A chave deve ser mantida em sigilo.

---

Configurando a API no VS Code

Após gerar a chave:

Opção 1 — Configurações Gráficas

1. Abra o VS Code
2. Pressione:

Ctrl + ,

3. Na busca das configurações procure por:

Meu Chat

4. Localize:

Meu Chat: Groq Api Key

5. Cole sua chave da Groq

---

Opção 2 — JSON de Configurações

Abra:

Preferences: Open Settings (JSON)

Adicione:

{
  "meuChat.groqApiKey": "SUA_CHAVE_AQUI"
}

---

Como Utilizar

Importante

A extensão analisa o arquivo atualmente aberto no editor.

O arquivo precisa estar aberto

A análise é realizada sobre o conteúdo do arquivo ativo no VS Code.

Se nenhum arquivo estiver aberto, a extensão não terá código para analisar.

Fluxo recomendado

1. Abra o projeto
2. Abra o arquivo desejado
3. Abra o painel "Meu Chat"
4. Solicite a análise

Exemplo:

Analise este código

ou

Quais melhorias podem ser feitas?

ou

Encontre possíveis bugs

---

Processo de Análise

Quando uma solicitação é enviada:

1. O conteúdo do arquivo aberto é capturado.
2. O Agente 1 gera sua análise.
3. O Agente 2 gera sua análise.
4. O Agente Judge compara ambas.
5. A melhor resposta é selecionada.
6. O resultado final é exibido ao usuário.

Fluxo simplificado:

Arquivo Aberto
       │
       ▼
 ┌──────────┐
 │ Agente 1 │
 └──────────┘
       │
       ▼
 ┌──────────┐
 │ Agente 2 │
 └──────────┘
       │
       ▼
 ┌──────────┐
 │  Judge   │
 └──────────┘
       │
       ▼
Resposta Final

---

Boas Práticas

Para obter melhores resultados:

• Analise arquivos individuais
• Mantenha o código formatado
• Forneça contexto quando necessário
• Faça perguntas específicas

Exemplos:

Existe risco de SQL Injection?

Avalie a arquitetura deste serviço.

Como melhorar a performance?

Identifique bugs potenciais.

---

Solução de Problemas

Nenhuma resposta retornada

Verifique:

• Se a chave da API está configurada
• Se há conexão com a internet
• Se o arquivo está aberto no editor

Erro de autenticação

Verifique se a chave da Groq ainda é válida.

A análise parece incorreta

Tente fornecer uma pergunta mais específica ou analisar um arquivo menor.

---

Privacidade

A extensão envia o conteúdo do arquivo atualmente aberto para os modelos configurados na Groq para realizar a análise.

Não compartilhe informações sensíveis, segredos, senhas ou credenciais em arquivos que serão enviados para análise.

---

Changelog

0.0.1

• Primeira versão pública
• Integração com Groq
• Análise baseada em múltiplos agentes
• Sistema Judge para seleção da melhor resposta
• Painel integrado ao Visual Studio Code