Contrôlez les dépenses
Contrôlez les dépenses de votre équipe liées aux agents de codage dans Unity AI Gateway. Définissez des budgets, choisissez des modèles qui établissent un équilibre entre le coût et les fonctionnalités, et utilisez Smart Routing pour optimiser la sélection des modèles.
Définir des budgets
Créez un budget mensuel avec Unity Gateway comme type de ressource. Choisissez des seuils pour votre équipe :
Seuil | Ce qu’il contrôle |
|---|---|
Partagé | Dépenses totales des utilisateurs dans le périmètre du budget. |
Par utilisateur | Dépenses pour chaque utilisateur individuel. |
Remplacement par utilisateur | Une allocation plus élevée pour des utilisateurs ou groupes spécifiques. |
Pour chaque threshold partagé ou par utilisateur, choisissez Envoyer une alerte , Bloquer l’utilisation ou les deux. Les alertes notifient les destinataires configurés. Le blocage empêche toute nouvelle requête de la passerelle jusqu’à la réinitialisation du budget ou jusqu’à ce qu’un administrateur augmente le threshold.
Si votre équipe utilise des fournisseurs de modèles externes, activez l'aperçu Dépenses liées aux modèles externes dans les budgets et sélectionnez Inclure l'utilisation des modèles externes . Les dépenses externes estimées sont alors prises en compte dans les mêmes threshold.
L’application du budget utilise des estimations en quasi-temps réel. Les requêtes déjà en cours peuvent se terminer, de sorte que la dépense finale peut dépasser le threshold. Les estimations externes peuvent également différer de la facture du fournisseur.
For setup and coverage details, see Manage budgets for Unity Gateway.
Définir les modèles default et les default intelligents
Modifiez ces paramètres dans la configuration de votre agent de codage. Merge les champs ci-dessous dans la configuration existante, puis enregistrez pour publier vos modifications.
Définir un modèle par default
Choisissez le modèle avec lequel chaque agent start pour son travail quotidien. Pour Claude Code, ajoutez les éléments suivants dans son objet config sous enabled_agents:
{
"default_models": {
"default_model": "system.ai.claude-sonnet-4-6"
}
}
Cela définit Claude Sonnet 4.6 comme default de Claude Code. Choisissez un modèle pris en charge par l’agent et veillez à ce que les développeurs y aient accès. ug utilise cette valeur default lorsqu’aucune recommandation de valeur par défaut intelligente ni aucun choix de modèle explicite ne s’applique.
Pour Claude Code, vous pouvez également associer ses familles de modèles Opus, Sonnet, Haiku et Fable à des modèles spécifiques :
{
"default_models": {
"default_model": "system.ai.claude-sonnet-4-6",
"default_opus_model": "system.ai.claude-opus-4-8",
"default_sonnet_model": "system.ai.claude-sonnet-4-6",
"default_haiku_model": "system.ai.claude-haiku-4-5",
"default_fable_model": "system.ai.claude-fable-5"
}
}
Spécifiez uniquement les correspondances de familles que vous souhaitez remplacer. Si models utilise un service de fournisseur de modèles, utilisez les ID de modèle de ce service de fournisseur. Sinon, utilisez les noms complets du service de modèle Unity Catalog. Avec une liste statique model_services, chaque default doit également apparaître dans cette liste.
Ajustez les recommandations à mesure que les dépenses augmentent
Bêta
Les valeurs par défaut intelligentes sont en version bêta. Un administrateur de compte doit activer l'aperçu Enhanced Unity Gateway depuis la page Previews de la console de compte. Consultez Gérer les aperçus Databricks.
Pour recommander un agent et un modèle différents à mesure que les dépenses augmentent, ajoutez smart_defaults au niveau supérieur de la configuration de votre agent de programmation existant :
{
"smart_defaults": {
"budget_id": "<budget-configuration-uuid>",
"tiers": [
{
"spending_percentage": 0.8,
"recommended_agent": "CODING_AGENT_CLAUDE_CODE",
"recommended_model": "system.ai.claude-haiku-4-5"
}
]
}
}
Remplacez l'identifiant de budget par l'budget_configuration_id de votre budget. La valeur 0.8 signifie 80 % du threshold de budget applicable. À ce stade, cet exemple recommande Claude Code avec Claude Haiku 4.5. Incluez l'agent recommandé dans enabled_agents et accordez aux développeurs l'accès au modèle. Si cet agent utilise une liste model_services statique, incluez le modèle recommandé dans la liste. Pour plusieurs niveaux, le threshold le plus élevé atteint détermine la recommandation.
L’exécution de ug lance l’agent et le modèle recommandés. Une commande spécifique à l’agent conserve l’agent choisi et applique une recommandation de modèle uniquement si elle cible cet agent. Un --model explicite remplace la recommandation.
Les valeurs par défaut intelligentes affectent les nouveaux lancements ; elles ne commutent pas les sessions actives et ne restreignent pas l'accès aux modèles. Utilisez le blocage du budget pour interrompre les requêtes supplémentaires et les autorisations Unity Catalog pour en restreindre l'accès.
Utilisez des modèles ouverts
Databricks prend en charge l'exécution de modèles open source (OSS), tels que glm-5-2, avec des agents de codage via Unity Gateway. Les modèles OSS peuvent réduire considérablement le coût par jeton pour les tâches de codage de routine. Définissez un modèle OSS comme default d'un agent dans votre configuration ou demandez aux développeurs d'en sélectionner un au lancement.
Pour consulter des exemples de lancement et la configuration manuelle, consultez Sélectionner des modèles. Pour voir quels agents prennent en charge les modèles ouverts, consultez Agents de programmation pris en charge.
Comprendre l'aiguillage intelligent
L'Aiguillage intelligent sélectionne automatiquement le modèle le moins coûteux capable de traiter chaque tâche, de sorte que les développeurs n'ont pas à choisir un modèle pour chaque requête. Il fonctionne avec Claude Code et Codex et peut sélectionner un modèle différent de la recommandation default ou intelligente default de l'équipe.
Pour activer Smart Routing par default, ajoutez smart_routing à l'intérieur de l'objet config existant de chaque agent pris en charge :
{
"smart_routing": {
"enabled": true
}
}
Publish the configuration. When developers launch with ug claude or ug codex, the CLI applies Smart Routing automatically. To stop enabling Smart Routing by default, set enabled to false and publish the update.
Pour la configuration et le comportement du développeur, consultez Sélectionner des modèles ou utiliser l'Aiguillage intelligent.
Smart Routing limitations
- Smart Routing ne prend en charge qu’une liste
models.model_servicesstatique dont les entrées commencent parsystem.ai.. Vous ne pouvez pas activer Smart Routing avecmodel_provider_service,unity_catalog_location, un modèle personnalisé, un fournisseur externe ou un service de modèle en dehors desystem.ai. - Les administrateurs du Workspace doivent accorder aux développeurs l’accès à chaque modèle candidat.
- La passerelle Unity CLI achemine les requêtes entre les différents modèles au sein d'un harnais. Le routage entre les différents harnais requiert Omnigent v0.8.0 ou une version ultérieure.
- Native Claude Code and Codex sessions that do not use the Unity Gateway CLI do not support Smart Routing through Unity Gateway.
Examiner les dépenses
Examinez l'utilisation et les dépenses pour ajuster vos budgets et vos choix de modèles. Consultez Surveiller l'activité des agents de codage.