Seções da Base de Conhecimento ▾

Navegação

▸ Comece aqui Por funções

Categorias

Ferramentas 32
Glossário 12

Ferramentas

Roo Code + Gonka AI — Agente de IA autônomo no VS Code

Roo Code é um agente de IA autônomo para VS Code: lê e edita arquivos, executa comandos no terminal, navega na web e completa tarefas de desenvolvimento de várias etapas. É um fork do Cline que foi além: modos de operação personalizáveis (Architect, Code, Ask, Debug e personalizados), instruções personalizadas por projeto e um painel flexível de configuração de modelo. Essencialmente, é uma equipe inteira de especialistas em IA dentro do editor.

O principal problema desses agentes é o consumo de tokens. Para uma única tarefa, o Roo Code processa o contexto de arquivos, saída de comandos, resultados de ferramentas — são dezenas de milhões de tokens. Com os preços da Anthropic (US$ 3-15 por 1M), uma sessão completa se transforma em US$ 30-1500. Para o trabalho diário, isso é inviável.

O JoinGonka Gateway reduz o custo em milhares de vezes: a mesma sessão custaria US$ 0,01-1,00. O Gateway revende a inferência da rede descentralizada Gonka e suporta tanto o formato OpenAI (provedor "OpenAI Compatible") quanto o formato Anthropic (endpoint /v1/messages) — o Roo Code se conecta através de um dos dois. Isso transforma o Roo Code de uma demonstração cara em uma ferramenta de trabalho diário.

Passo 1: Instalar Roo Code e obter chave

Instalação do Roo Code: no VS Code, abra Extensões (Ctrl/Cmd+Shift+X), procure por “Roo Code” e clique em Instalar. Após a instalação, um ícone de canguru do Roo Code aparecerá na barra lateral.

Chave API JoinGonka: se ainda não tem uma chave — registre-se em gate.joingonka.ai/register, obtenha 10M de tokens gratuitos e crie uma chave com o prefixo jg- no Dashboard.

Passo 2: Configurar Roo Code (OpenAI Compatible)

A maneira mais fácil é configurar com o instalador em um único comando. Para ferramentas CLI/arquivos, ele configurará automaticamente o provedor JoinGonka (baseUrl, modelos), e para ferramentas de UI mostrará os valores prontos para colar:

npx @joingonka/setup --tool roo

O instalador é universal (se não usar flag, solicitará a escolha da ferramenta em uma lista), pedirá a chave jg-… e após a configuração fará uma verificação ao vivo através de uma requisição ao gateway. Ele não altera outras configurações. Abaixo, o método manual caso prefira configurar você mesmo.

Configurar manualmente (Plano B)

Abra o painel do Roo Code e vá para as configurações (ícone de engrenagem). Na seção do provedor, defina:

  1. API Provider — escolha OpenAI Compatible.
  2. Base URLhttps://gate.joingonka.ai/v1
  3. API Keyjg-sua-chave
  4. Model (Model ID) — MiniMaxAI/MiniMax-M2.7

Abaixo, no bloco Model Configuration, você pode ajustar os parâmetros do modelo manualmente:

  • Context Window200000 (200K tokens).
  • Max Output Tokens8192 (limite do Gateway, para todos os modelos da rede).
  • Input Price / Output Price — você pode preencher as taxas reais (≈$0.003 por 1M de entrada, saída ×3) para que o Roo Code calcule corretamente o custo das tarefas diretamente na interface.

Importante sobre tool calling: o Roo Code usa apenas tool calling nativo — não há fallback de XML, como em agentes antigos. Portanto, o modelo deve ser capaz de fazer function calling. Os modelos da rede via nosso Gateway suportam tool calling nativo — o Roo Code funciona perfeitamente com eles.

Verificação: no chat do Roo Code, escreva «Crie um arquivo hello.py com uma função que imprima Hello World». O agente proporá criar o arquivo e mostrará o diff para aprovação.

Comparação de custos de sessões de agente

Roo Code — uma ferramenta de agente: ele não responde com apenas uma mensagem, mas executa a tarefa — lê arquivos, escreve código, executa testes, corrige erros. Cada ação é uma chamada ao modelo. Comparemos o custo de sessões típicas:

TarefaTokensAnthropic ClaudeOpenAI GPTJoinGonka Gonka
Correção de bug simples~5M$15 — $75$12 — $50$0.024
Nova funcionalidade (2-3 arquivos)~20M$60 — $300$50 — $200$0.096
Refatoração de módulo~50M$150 — $750$125 — $500$0.24
Sessão completa de desenvolvimento (4h)~100M$300 — $1,500$250 — $1,000$0.48

Com o JoinGonka Gateway, o Roo Code torna-se uma ferramenta do dia a dia — pode ser executado para cada ticket, cada bug, cada funcionalidade sem olhar o custo. 10M de tokens gratuitos no início são suficientes para dezenas de tarefas.

Parâmetros dos modelos (contexto de 200K para todos): todos os modelos da rede permitem até 8192 tokens de resposta. Se max_tokens para a requisição non-stream não for especificado, o Gateway por padrão retornará até 1500 tokens. O Roo Code divide automaticamente as gerações longas em passos.

O que Roo Code tem de diferente do Cline: modos e formato Anthropic

O Roo Code é um fork do Cline, mas com diferenças notáveis que alteram o fluxo de trabalho:

  • Modos (Modes): alterne a função do agente conforme a tarefa — Architect para planejamento, Code para escrever código, Ask para perguntas sobre o projeto, Debug para procurar erros. Você pode criar modos personalizados com instruções individuais e um conjunto de ferramentas permitidas.
  • Apenas tool calling nativo: diferentemente dos agentes com parsing de texto/XML, o Roo Code envia ferramentas seguindo o esquema nativo tools da OpenAI e recebe chamadas como eventos separados — menor latência e resultados mais confiáveis. O contraponto: o modelo deve suportar function calling (os modelos da rede através do nosso Gateway suportam).
  • Instruções e perfis personalizados: regras por projeto (por exemplo, através de um arquivo de regras no repositório) e várias configurações de provedor salvas, entre as quais é fácil alternar.

Conexão via formato Anthropic. Se desejar usar nosso endpoint /v1/messages em vez do formato OpenAI: nas configurações selecione API Provider → Anthropic, marque «Use custom base URL» e indique https://gate.joingonka.ai, no campo Anthropic API Key insira a mesma chave jg-sua-chave, depois defina o nome do modelo (por exemplo MiniMaxAI/MiniMax-M2.7). A chave e o saldo são compartilhados para ambos os formatos, e o tool_use nativo no modo Anthropic também passa pelo Gateway.

Roo Code + Gonka = agente de IA autônomo no VS Code com modos e chamada de ferramenta nativa por alguns centavos. Uma sessão de desenvolvimento custa US$ 0,10 em vez de US$ 300-1.500 na Anthropic, e 10M de tokens gratuitos são suficientes para dezenas de tarefas.

Quer saber mais?

Explore outras seções ou comece a ganhar GNK agora mesmo.

Obtenha 10M de tokens gratuitos →