Sélectionner des modèles ou utiliser l’aiguillage intelligent
Unity Gateway vous permet d’utiliser différents modèles dans votre agent de code. Choisissez un modèle au start, changez-en en cours de travail, ou laissez Smart Routing en sélectionner un pour votre tâche.
Choisissez un modèle
ug découvre les modèles disponibles dans votre workspace. Vos choix dépendent de la prise en charge des modèles par l'agent, de la configuration de votre organisation et des accès qui vous ont été accordés.
Choisissez un modèle au lancement
Ajoutez --model à la commande de lancement de votre agent, en utilisant le nom complet d'un modèle à votre disposition :
ug claude --model system.ai.claude-sonnet-4-6
ug codex --model system.ai.gpt-5-5
L'agent s'ouvre avec ce modèle, prêt pour votre workflow habituel. Sans --model, il start avec sa configuration default.
Pour réduire le coût par jeton pour le travail de routine, lancez un modèle open source, tel que system.ai.glm-5-2:
ug codex --model system.ai.glm-5-2
Avec OpenCode, exécutez ug opencode et sélectionnez un modèle open source tel que system.ai.glm-5-2. Pour savoir quels agents prennent en charge les modèles ouverts, consultez la page Agents de codage pris en charge. Pour en savoir plus sur la justification des coûts, consultez la section Contrôler les dépenses.
Pour acheminer plutôt les requêtes via le compte de fournisseur enregistré de votre organisation, transmettez son nom Unity Catalog à --provider. Consultez la page Fournisseurs de modèles personnalisés (Bring Your Own Model).
Changer de modèle pendant une session
Dans la plupart des agents de codage, saisissez :
/model
Sélectionnez un modèle dans le sélecteur et continuez à travailler. Vous pouvez utiliser un modèle plus rapide pour les modifications courantes et passer à un modèle plus puissant pour une tâche complexe.
La commande varie selon l'agent. Si /model n'est pas disponible, consultez le menu d'aide de votre agent pour accéder à son sélecteur de modèle.
Utilisez Smart Routing
Bêta
Le routage intelligent est en version bêta. Un administrateur de compte doit activer l’aperçu de Enhanced Unity Gateway depuis la page Previews de la console du compte. Consultez Gérer les aperçus Databricks.
Le routage intelligent sélectionne le modèle au coût le plus bas capable de traiter votre tâche, afin que vous n'ayez pas à choisir un modèle pour chaque requête. Il fonctionne avec Claude Code et Codex.
Prérequis
-
L’aperçu de Unity Gateway améliorée est activé pour votre compte. Un administrateur de compte l’active depuis la page Aperçus de la console du compte. Consultez la page Gérer les aperçus Databricks. Prévoyez 1 à 2 minutes après l’activation pour que les modifications soient propagées à votre workspace.
-
EXECUTEl’accès à tous les modèles candidats qu’Aiguillage intelligent peut sélectionner. Aiguillage intelligent ne choisit que parmi les services de modèle préfixés parsystem.ai. Si l’accès est manquant, le routage échoue avec une erreur qui identifie les modèles requis. -
Un workspace Databricks dans une région prise en charge par Unity Gateway.
Utiliser le routage intelligent avec la CLI Unity Gateway
Si votre administrateur active Smart Routing dans la configuration du workspace de votre agent, ug l’applique automatiquement. Lancez votre agent comme d’habitude :
ug claude
ug codex
Pour activer vous-même l’Aiguillage intelligent pour un lancement, ajoutez --enable-smart-routing:
ug claude --enable-smart-routing
ug codex --enable-smart-routing
Pour le désactiver à nouveau, lancez-le avec --disable-smart-routing.
Après avoir soumis votre premier prompt, l'aiguillage intelligent sélectionne un modèle pour la session. Une notification dans l'agent indique le modèle sélectionné et, lorsqu'il est disponible, le motif de ce choix :
Using Unity Gateway Smart Router.
Selected Model : <model name>
Reason : <reason for the selection>
The agent continues with the selected model. If it delegates work to subagents, each subagent's task is routed independently and can use a different model.
Pour choisir vous-même le modèle, lancez avec --model. Une sélection explicite de modèle l'emporte sur le routage intelligent pour ce lancement.
Utiliser l'aiguillage intelligent dans Omnigent
Omnigent peut sélectionner à la fois le harnais de codage et le modèle pour une tâche, y compris pour le travail délégué à des sous-agents. Utilisez la version v0.8.0 ou ultérieure.
Configurez Claude Code et Codex pour votre workspace Databricks :
omni setup
Connect your computer to the Omnigent server:
omni host --server <workspace-url>
Remplacez <workspace-url> par l'URL de votre workspace Databricks.
Dans l'interface utilisateur d'Omnigent, sélectionnez Smart Routing comme harnais pour lui permettre de choisir à la fois le harnais et le modèle :
Pour conserver Claude Code ou Codex, sélectionnez cet harnais, ouvrez son menu en forme de rouage et choisissez Smart Routing pour le modèle :
Vous pouvez également activer le routage des modèles à partir de la CLI pour un harness choisi :
omni claude --smart-routing --server <workspace-url>
omni codex --smart-routing --server <workspace-url>
La CLI Unity Gateway achemine les requêtes entre les modèles du harness pris en charge sélectionné. Omnigent effectue également une sélection parmi les différents harnais ; les exemples omni claude et omni codex choisissent explicitement un harnais.