Roo Code + Gonka AI — agente AI autonomo in VS Code

Installazione di Roo Code: in VS Code, apri le estensioni (Ctrl/Cmd+Shift+X), cerca "Roo Code" e fai clic su Installa. Dopo l'installazione, l'icona del canguro di Roo Code apparirà nella barra laterale.

Chiave API JoinGonka: se non hai ancora una chiave, registrati su gate.joingonka.ai/register, ottieni 10 milioni di token gratuiti e crea una chiave con il prefisso jg- nella Dashboard.

Apri il pannello Roo Code e vai alle impostazioni (icona a forma di ingranaggio). Nella sezione del provider, imposta:

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

Sotto, nel blocco Model Configuration, puoi specificare manualmente i parametri del modello:

• Context Window — 131072 (128K token).
• Max Output Tokens — 8192 per Qwen3-235B (limite di Gateway). Per Kimi K2.6 imposta 3072, per MiniMax M2.7 — 4096.
• Input Price / Output Price — puoi inserire i tassi reali (≈$0.0005 per 1M in ingresso, uscita ×3) in modo che Roo Code calcoli correttamente il costo delle attività direttamente nell'interfaccia.

Importante sul tool calling: Roo Code utilizza solo il tool calling nativo — non c'è un fallback XML come nei vecchi agenti. Pertanto, il modello deve supportare il function calling. Il Qwen3-235B predefinito tramite il nostro Gateway supporta il tool calling nativo — Roo Code funziona con esso fin da subito.

Verifica: nella chat di Roo Code, scrivi "Crea un file hello.py con una funzione che stampa Hello World". L'agente proporrà di creare il file e mostrerà il diff per l'approvazione.

Roo Code è uno strumento agente: non risponde con un singolo messaggio, ma esegue un compito — legge file, scrive codice, esegue test, corregge bug. Ogni azione è una chiamata al modello. Confrontiamo il costo delle sessioni tipiche:

Con JoinGonka Gateway Roo Code diventa uno strumento quotidiano — può essere eseguito per ogni ticket, ogni bug, ogni funzionalità, senza preoccuparsi dei costi. 10 milioni di token gratuiti all'inizio saranno sufficienti per decine di compiti.

Parametri del modello (contesto per tutti 128K = 131072 token): Qwen3-235B — fino a 8192 token di risposta; Kimi K2.6 — fino a 3072; MiniMax M2.7 — fino a 4096. Se max_tokens non è specificato per una richiesta non in streaming, Gateway restituirà per impostazione predefinita fino a 1500 token. Roo Code suddivide automaticamente le generazioni lunghe in passi.

Roo Code è un fork di Cline, ma con differenze significative che cambiano il flusso di lavoro:

• Modalità (Modes): cambia il ruolo dell'agente in base al compito — Architect per la pianificazione, Code per la scrittura del codice, Ask per le domande sul progetto, Debug per la ricerca di errori. Puoi creare le tue modalità con istruzioni separate e un set di strumenti consentiti.
• Solo tool calling nativo: a differenza degli agenti con parsing di testo/XML, Roo Code invia gli strumenti tramite lo schema nativo OpenAI tools e riceve le chiamate come eventi separati — latenza inferiore e risultato più affidabile. Il rovescio della medaglia: il modello deve supportare il function calling (Qwen3-235B tramite il nostro Gateway lo supporta).
• Istruzioni e profili personalizzati: regole per il progetto (ad esempio, tramite un file di regole nel repository) e diverse configurazioni del provider salvate, tra cui è comodo passare.

Connessione tramite formato Anthropic. Se desideri utilizzare il nostro endpoint /v1/messages invece del formato OpenAI: nelle impostazioni, seleziona API Provider → Anthropic, seleziona "Use custom base URL" e specifica https://gate.joingonka.ai, nel campo Anthropic API Key inserisci la stessa chiave jg-la-tua-chiave, quindi imposta il nome del modello (ad esempio Qwen/Qwen3-235B-A22B-Instruct-2507-FP8). La chiave e il saldo sono comuni a entrambi i formati, il tool_use nativo in modalità Anthropic passa anch'esso tramite Gateway.