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 voir quels agents prennent en charge les modèles open source, consultez Agents de codage et de travail pris en charge. Pour connaître la justification des coûts, consultez 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 pour un lancement, y compris lorsque votre administrateur l’active, lancez-le avec --disable-smart-routing.
Pour désactiver ou réactiver Smart Routing pendant une session, entrez :
- Claude Code :
/smart-router offou/smart-router on - Codex :
$smart-router offou$smart-router on
Avec Smart Routing activé, votre agent transmet des tâches à des sous-agents. La tâche de chaque sous-agent est routée indépendamment et peut utiliser un modèle différent. L'agent montre le modèle sélectionné pour chaque sous-agent et, lorsqu'il est disponible, la raison de ce choix. La session principale reste sur son modèle default : le modèle default ou le modèle intelligent default de votre administrateur si un modèle est défini, sinon le modèle default configuré de l'agent. Pour conserver une tâche dans la session principale, demandez à l'agent de ne pas utiliser de sous-agents.
Pour des contrôles de sécurité automatiques des appels d’outils avec des sous-agents Claude Code utilisant des modèles de fondation non Anthropic hébergés par Databricks, voir Mode automatique.
Pour choisir le modèle vous-même, lancez avec --model. Le routage intelligent est désactivé pour ce lancement, y compris pour les sous-agents.
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.