Kontrolle der Ausgaben

Kontrollieren Sie, wie viel Ihr Team für Coding-Agenten in Unity Gateway ausgibt. Setzen Sie Budgets, wählen Sie Modelle aus, die Kosten und Funktionalität ausbalancieren, und nutzen Sie Smart Routing, um die Modellauswahl zu optimieren.

Festlegen von Budgets

Erstellen Sie ein monatliches Budget mit Unity Gateway als Ressourcentyp. Wählen Sie Schwellenwerte für Ihr Team:

Schwellenwert Was sie steuert
Shared Gesamtausgaben aller Nutzer im Budgetrahmen.
Pro Benutzer Geben Sie für jeden einzelnen Nutzer aus.
Benutzerspezifische Überschreibung Eine höhere Zuwendung für bestimmte Nutzer oder Gruppen.

Für jede geteilte oder Benutzer-Schwelle wählen Sie Benachrichtigung senden, Nutzung blockieren oder beides. Benachrichtigungen benachrichtigen die konfigurierten Empfänger. Das Blockieren verhindert weitere Gateway-Anfragen, bis das Budget zurückgesetzt wird oder ein Administrator die Schwelle erhöht.

Wenn Ihr Team externe Modellanbieter nutzt, aktivieren Sie die Vorschau "Externe Modellausgaben in den Budgets" und wählen Sie "Externe Modellnutzung einbeziehen". Die geschätzten externen Ausgaben zählen dann zu denselben Schwellenwerten.

Die Haushaltsdurchsetzung verwendet nahezu Echtzeit-Schätzungen. Bereits laufende Anfragen können abgeschlossen werden, sodass die endgültigen Ausgaben den Schwellenwert überschreiten können. Auch externe Kostenvoranschläge können von der Rechnung des Anbieters abweichen.

Informationen zur Einrichtung und zum Geltungsbereich finden Sie unter Budgets für Unity Gateway verwalten.

Standardwerte für Modelle und intelligente Standardwerte festlegen

Bearbeiten Sie diese Einstellungen in Ihrer Coding-Agent-Konfiguration. Füge die untenstehenden Felder in die bestehende Konfiguration ein und speichere dann, um deine Änderungen zu veröffentlichen.

Setzen Sie ein Standardmodell

Wählen Sie das Modell, mit dem jeder Agent für die tägliche Arbeit beginnt. Für Claude Code fügen Sie Folgendes in sein config Objekt unter enabled_agents:

{
  "default_models": {
    "default_model": "system.ai.claude-sonnet-4-6"
  }
}

Dadurch wird Claude Sonnet 4.6 als Standardversion von Claude Code gesetzt. Wählen Sie ein vom Agenten unterstütztes Modell und stellen Sie sicher, dass die Entwickler Zugriff darauf haben. ug verwendet diesen Standard, wenn keine SMART-Standard-Empfehlung oder explizite Modellwahl gilt.

Für Claude Code können Sie auch die Modellfamilien Opus, Sonnet, Haiku und Fable bestimmten Modellen zuordnen:

{
  "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"
  }
}

Gib nur die Familienzuordnungen an, die du überschreiben möchtest. Wenn models einen Modell-Anbieterdienst verwendet, verwenden Sie die Modell-IDs dieses Anbieterdienstes. Ansonsten verwenden Sie die vollständigen Unity-Catalog-Modell-Servicenamen. Bei einer statischen model_services Liste muss auch jeder Standard in dieser Liste erscheinen.

Anpassung der Empfehlungen bei steigenden Ausgaben

Important

Smart Defaults befinden sich in der Beta. Ein Kontoadministrator muss die Vorschau des Enhanced Unity Gateway über die Vorschauseiten der Kontokonsole aktivieren. Siehe Manage Azure Databricks Previews.

Um bei steigenden Ausgaben einen anderen Agenten und ein anderes Modell zu empfehlen, fügen Sie smart_defaults auf der obersten Ebene der Konfiguration Ihres bestehenden Coding-Agenten hinzu:

{
  "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"
      }
    ]
  }
}

Ersetzen Sie die Budget-ID durch die budget_configuration_id Ihres Budgets. Der Wert 0.8 entspricht 80% der anfallenden Haushaltsschwelle. An diesem Punkt empfiehlt dieses Beispiel Claude Code mit Claude Haiku 4.5. Schließen Sie den empfohlenen Agenten in enabled_agents ein und gewähren Sie Entwicklern Zugriff auf das Modell. Wenn dieser Agent eine statische model_services Liste verwendet, fügen Sie das empfohlene Modell in die Liste ein. Für mehrere Stufen bestimmt die höchste erreichte Schwelle die Empfehlung.

Beim Ausführen von ug werden der empfohlene Agent und das empfohlene Modell gestartet. Ein agentenspezifischer Befehl behält den gewählten Agenten und wendet eine Modellempfehlung nur dann an, wenn er diesen Agenten anvisiert. Ein explizites --model setzt die Empfehlung außer Kraft.

Intelligente Standardwerte beeinflussen neue Starts; sie wechseln keine aktiven Sitzungen oder schränken den Modellzugriff ein. Nutze Budgetblockierung, um weitere Anfragen zu stoppen, und Unity-Katalog-Berechtigungen , um den Zugriff einzuschränken.

Verwenden Sie offene Modelle

Azure Databricks unterstützt das Ausführen von Open Source (OSS)-Modellen, wie glm-5-2, mit Coding-Agenten über Unity Gateway. OSS-Modelle können die Kosten pro Token für routinemäßige Codierungsaufgaben erheblich senken. Setze in deiner Konfiguration ein OSS-Modell als Standard eines Agenten oder lass die Entwickler beim Start eines auswählen.

Für Startbeispiele und manuelle Einrichtung siehe Ausgewählte Modelle. Um zu sehen, welche Agenten offene Modelle unterstützen, siehe Unterstützte Coding-Agenten.

Verstehen Sie Smart Routing

Smart Routing wählt automatisch das kostengünstigste Modell aus, das jede Aufgabe bewältigen kann, sodass Entwickler nicht für jede Anfrage ein Modell wählen müssen. Es funktioniert mit Claude Code und Codex und kann ein anderes Modell als die Standardvorgabe oder die Smart-Default-Empfehlung des Teams auswählen.

Um Smart Routing standardmäßig zu aktivieren, fügen Sie config innerhalb des vorhandenen smart_routing-Objekts jedes unterstützten Agenten hinzu:

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

Veröffentlichen Sie die Konfiguration. Wenn Entwickler mit ug claude oder ug codexstarten, wendet die CLI Smart Routing automatisch an. Um die standardmäßige Aktivierung von Smart Routing zu deaktivieren, setzen Sie enabled auf false und veröffentlichen Sie die Aktualisierung.

Für Entwickler-Einrichtung und -verhalten siehe Select models oder nutze Smart Routing.

Einschränkungen des Smart Routing

  • Smart Routing unterstützt nur eine statische models.model_services Liste, deren Einträge mit system.ai.beginnen. Du kannst Smart Routing nicht mit einem model_provider_service, einem unity_catalog_location, einem benutzerdefinierten Modell, einem externen Anbieter oder einem Modelldienst außerhalb von system.ai aktivieren.
  • Workspace-Administratoren müssen Entwicklern Zugang zu jedem Kandidatenmodell gewähren.
  • Die Unity-Gateway-CLI leitet den Datenverkehr zwischen Modellen innerhalb eines Harness weiter. Harnessübergreifendes Routing erfordert Omnigent v0.8.0 oder höher.
  • Native Claude Code- und Codex-Sitzungen, die die Unity Gateway CLI nicht verwenden, unterstützen kein Smart Routing über Unity Gateway.

Überprüfung der Ausgaben

Überprüfen Sie Verbrauch und Ausgaben, um Ihr Budget und Ihre Modellwahl anzupassen. Siehe Aktivität von Codierungsagenten überwachen.

Weitere Ressourcen