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

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.

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

1. API Provider — selecione OpenAI Compatible.
2. Base URL — https://gate.joingonka.ai/v1
3. API Key — jg-sua-chave
4. Model (Model ID) — Qwen/Qwen3-235B-A22B-Instruct-2507-FP8

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

• Context Window — 131072 (128K tokens).
• Max Output Tokens — 8192 para Qwen3-235B (limite do Gateway). Para Kimi K2.6 defina 3072, para MiniMax M2.7 — 4096.
• Input Price / Output Price — você pode definir as taxas reais (≈US$ 0,0005 por 1M na 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 XML, como nos agentes antigos. Portanto, o modelo deve ser capaz de chamar funções. O Qwen3-235B padrão, através do nosso Gateway, suporta tool calling nativo — o Roo Code funciona com ele de imediato.

Verificação: no chat do Roo Code, escreva “Crie um arquivo hello.py com uma função que imprima Hello World”. O agente sugerirá criar o arquivo e mostrará as diferenças para aprovação.

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

Com o JoinGonka Gateway, o Roo Code se torna uma ferramenta diária — você pode executá-lo em cada ticket, cada bug, cada funcionalidade, sem se preocupar com a fatura. Os 10M de tokens gratuitos no início são suficientes para dezenas de tarefas.

Parâmetros do modelo (contexto de todos 128K = 131072 tokens): Qwen3-235B — até 8192 tokens de resposta; Kimi K2.6 — até 3072; MiniMax M2.7 — até 4096. Se max_tokens para uma solicitação não-stream não for especificado, o Gateway por padrão retornará até 1500 tokens. O Roo Code divide automaticamente as gerações longas em etapas.

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 para a tarefa — Architect para planejamento, Code para escrever código, Ask para perguntas sobre o projeto, Debug para encontrar erros. Você pode criar seus próprios modos com instruções separadas e um conjunto de ferramentas permitidas.
• Apenas chamadas de ferramenta nativas: ao contrário dos agentes com parsing de texto/XML, o Roo Code envia as ferramentas de acordo com o esquema nativo tools do OpenAI e recebe as chamadas como eventos separados — menor latência e resultado mais confiável. O lado negativo: o modelo deve suportar a chamada de função (Qwen3-235B através do nosso Gateway — suporta).
• 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 você quiser usar nosso endpoint /v1/messages em vez do formato OpenAI: nas configurações, selecione API Provider → Anthropic, marque “Use custom base URL” e especifique https://gate.joingonka.ai, no campo Anthropic API Key cole a mesma chave jg-sua-chave, depois defina o nome do modelo (por exemplo, Qwen/Qwen3-235B-A22B-Instruct-2507-FP8). A chave e o saldo são comuns para ambos os formatos, o tool_use nativo no modo Anthropic também passa pelo Gateway.