Contrôler les dépenses

Contrôlez ce que votre équipe dépense en agents de codage dans Unity Gateway. Fixez des budgets, choisissez des modèles qui équilibrent coût et capacité, et utilisez Smart Routing pour optimiser la sélection des modèles.

Définir des budgets

Créez un budget mensuel en utilisant Unity Gateway comme type de ressource. Choisissez les seuils pour votre équipe :

Seuil Qu’est-ce qu’il contrôle ?
Shared Dépenses totales pour tous les utilisateurs dans le cadre du budget.
Par utilisateur Dépensez pour chaque utilisateur individuellement.
Remplacement par l’utilisateur Une allocation plus élevée pour des utilisateurs ou groupes spécifiques.

Pour chaque seuil partagé ou par utilisateur, choisissez Envoyer une alerte, Blocer l’utilisation, ou les deux. Les alertes notifient les destinataires configurés. Le blocage empêche toute nouvelle requête adressée à la passerelle jusqu’à ce que le budget soit réinitialisé ou qu’un administrateur augmente le seuil.

Si votre équipe utilise des fournisseurs de modèles externes, activez la Dépense de modèle externe dans l’aperçu des budgets et sélectionnez Inclure l’utilisation du modèle externe. Les dépenses externes estimées comptent alors pour les mêmes seuils.

Le contrôle budgétaire utilise des estimations presque en temps réel. Les requêtes déjà en cours peuvent être complétées, donc la dépense finale peut dépasser le seuil. Les devis externes peuvent également différer de la facture du prestataire.

Pour les détails de configuration et de couverture, voir Gérer les budgets pour Unity Gateway.

Définir les paramètres par défaut du modèle et les paramètres intelligents

Modifie ces paramètres dans la configuration de ton agent de codage. Fusionnez les champs ci-dessous dans la configuration existante, puis enregistrez pour publier vos modifications.

Définir un modèle par défaut

Choisissez le modèle avec lequel chaque agent commence pour le 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 modèle par défaut dans Claude Code. Choisissez un modèle pris en charge par l’agent et assurez-vous que les développeurs y ont accès. ug utilise ce par défaut lorsqu’aucune recommandation par défaut intelligente ou choix explicite de modèle ne s’applique.

Pour Claude Code, vous pouvez également associer ses familles de modèles Opus, Sonnet, Haïku 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 identifiants de modèle de ce fournisseur de services. Sinon, utilisez les noms complets des modèles de service du catalogue Unity. Avec une liste statique model_services , chaque défaut doit également apparaître dans cette liste.

Ajustez les recommandations à mesure que les dépenses augmentent

Important

Les paramètres par défaut intelligents sont en version bêta. Un administrateur de compte doit activer l’aperçu amélioré de la passerelle Unity depuis la page des Aperçus de la console de compte. Consultez Gérer les préversions d’Azure Databricks.

Pour recommander un autre agent et modèle à mesure que les dépenses augmentent, ajoutez smart_defaults au niveau supérieur de votre configuration actuelle d’agent codeur :

{
  "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’ID du budget par le budget_configuration_id de votre budget. La valeur 0.8 représente 80% du seuil budgétaire applicable. À ce stade, cet exemple recommande Claude Code avec Claude Haiku 4.5. Incluez l’agent recommandé dans enabled_agents le modèle et accordez aux développeurs l’accès au modèle. Si cet agent utilise une liste statique model_services , incluez le modèle recommandé dans la liste. Pour plusieurs niveaux, le seuil le plus élevé atteint détermine la recommandation.

L’exécution ug lance l’agent et le modèle recommandés. Une commande spécifique à l’agent conserve l’agent choisi et applique une recommandation modèle uniquement si elle cible cet agent. Un explicite --model passe outre la recommandation.

Les paramètres par défaut intelligents affectent les nouveaux lancements ; ils ne changent pas de sessions actives ni ne restreignent l’accès aux modèles. Utilisez le blocage budgétaire pour arrêter les demandes futures et les autorisations du catalogue Unity pour restreindre l’accès.

Utilisation de modèles ouverts

Azure 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 modèle par défaut pour un agent dans votre configuration, ou demandez aux développeurs d’en sélectionner un au lancement.

Pour des exemples de lancement et la configuration manuelle, voir Select models. Pour voir quels agents prennent en charge les modèles ouverts, voir Agents de codage supportés.

Comprendre le routage intelligent

Smart Routing 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 besoin de choisir un modèle pour chaque requête. Il fonctionne avec Claude Code et Codex et peut choisir un modèle différent de celui défini par défaut pour l’équipe ou de celui recommandé par défaut de manière intelligente.

Pour activer le routage intelligent par défaut, ajoutez smart_routing dans l’objet config existant de chaque agent pris en charge :

{
  "smart_routing": {
    "enabled": true
  }
}

Publiez la configuration. Lorsque les développeurs lancent avec ug claude ou ug codex, la CLI applique automatiquement le routage intelligent. Pour arrêter d’activer le routage intelligent par défaut, réglez enabled et false publiez la mise à jour.

Pour la configuration et le comportement du développeur, voir Sélectionner des modèles ou utiliser Smart Routing.

Limitations du routage intelligent

  • Smart Routing ne supporte qu’une liste statique models.model_services dont les entrées commencent par system.ai.. Vous ne pouvez pas activer Smart Routing avec un model_provider_service, un unity_catalog_location, un modèle personnalisé, un fournisseur externe ou un service de modèle en dehors de system.ai.
  • Les administrateurs d’espace de travail doivent accorder aux développeurs l’accès à chaque modèle candidat.
  • L’interface de ligne de commande Unity Gateway achemine les requêtes entre différents modèles au sein d’un environnement de test. Le routage entre faisceaux nécessite Omnigent v0.8.0 ou une version ultérieure.
  • Les sessions natives de code Claude et Codex qui n’utilisent pas la ligne de commande Unity Gateway ne prennent pas en charge le routage intelligent via Unity Gateway.

Passer en revue les dépenses

Examinez votre consommation et vos dépenses pour ajuster vos budgets et vos choix de modèles. Voir Surveiller l’activité de l’agent de codage.

Ressources additionnelles

  • Dernière mise à jour :