Instradamento e selezione dei modelli: la relazione tra canali, modelli e client
Quando si utilizza un gateway AI, i tre concetti più facili da confondere sono: canale, modello e client. Comprendere la loro relazione ti aiuta a configurare correttamente l'instradamento ed evita confusione del tipo «perché la mia richiesta non è passata dal canale che mi aspettavo».
Tre concetti fondamentali
- Un canale è una connessione upstream: un'istanza Ollama oppure un account di un provider cloud.
- Un modello è una capacità disponibile su un canale: ad esempio, un nome di modello specifico come
qwen3:8b. - Un client è lo strumento AI che utilizzi quotidianamente: Claude Code, Codex, opencode e simili.
La loro relazione forma una catena unidirezionale:
Client → (chiave virtuale) → Gateway (strategia di instradamento) → Canale → Modello
A ogni richiesta, è il client a specificare il nome del modello nella richiesta; il gateway, in base a quel nome, individua il canale in grado di servirla e gli inoltra la richiesta.
Cosa significa «model (nome canale)» nell'elenco dei modelli
Nel selettore dei modelli di client come Claude Code e opencode vedrai voci come qwen3:8b (Ollama Qwen3). Il nome tra parentesi indica il canale di origine del modello, non «un'altra connessione»:
- Tra il tuo client e il gateway c'è sempre una sola connessione (un indirizzo + una chiave virtuale).
- Lo stesso modello può essere configurato su più canali. In tal caso il selettore mostra comunque una sola riga (tra parentesi compare uno dei canali di origine); quale canale serva effettivamente ciascuna richiesta è deciso dalla strategia di instradamento (vedi sotto).
Le tre modalità di instradamento: Fixed, Failover, Balanced
La domanda a cui risponde la strategia di instradamento è: quando più canali possono servire lo stesso modello, quale si usa?
| Modalità | Comportamento | Scenari d'uso |
|---|---|---|
| Fixed (fissa) | Usa sempre lo stesso canale | Qualità del canale stabile, quando si vuole bloccare la fonte |
| Failover (primario/backup) | Se il canale principale fallisce o esaurisce la quota, passa in sequenza ai canali di backup | Configurazioni con un canale principale e uno di riserva |
| Balanced (bilanciata) | Distribuisce le richieste a rotazione tra i canali disponibili | Più canali omogenei tra cui ripartire il carico |
Due punti fondamentali da tenere a mente:
- L'instradamento cambia solo il canale, mai il modello. Il modello da richiedere è sempre deciso dal tuo client: il gateway non lo cambia al posto tuo.
- Modelli diversi seguono naturalmente canali propri. Balanced non fa «stavolta il modello del canale A, la prossima volta quello del canale B»: ruota solo tra i più canali del medesimo modello.
È il client a decidere il modello: come cambiarlo
Il gateway si limita all'inoltro: il tuo strumento include il nome del modello in ogni richiesta e il gateway la instrada di conseguenza. Il cambio di modello avviene nel client:
- opencode: digita
/modelsnella TUI per selezionarlo; oppure configuramodel(modello principale) esmall_model(per attività leggere come la generazione dei titoli) inopencode.json. - Claude Code: usa il comando
/modelper passare a un altro modello. - Codex: specifica il modello con il parametro
-m <model>o tramite il file di configurazione.
Collegare gli strumenti quotidiani al gateway in sicurezza
Temi ripercussioni sul tuo lavoro quotidiano? Segui questa procedura:
- Prova prima con un progetto secondario: esegui l'integrazione con un clic in una directory di progetto poco importante e verifica che il flusso di lavoro funzioni correttamente.
- Verifica con una singola richiesta: invia una richiesta di prova e consulta la pagina «Registro degli utilizzi» per vedere su quale modello e canale è stata elaborata e quanto è costata.
- Torna indietro in qualsiasi momento: interrompi la presa in carico dalla pagina «Gestione integrazioni». Una volta interrotta: le configurazioni scritte da ServBay verranno rimosse e le chiavi virtuali create dalla presa in carico verranno revocate; le tue configurazioni personalizzate precedenti non vengono ripristinate automaticamente, quindi, se necessario, modificale manualmente — le modifiche avranno effetto dopo il riavvio del client.
Riepilogo
- Canale = connessione upstream; modello = capacità presente sul canale; il nome del modello è specificato dal client in ogni richiesta.
- La strategia di instradamento sceglie solo tra «più canali dello stesso modello»: Fixed fisso, Failover primario/backup, Balanced a rotazione.
- Cambia modello dal selettore del client; verifica l'attribuzione e il costo di ogni richiesta nella pagina «Registro degli utilizzi».
