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 Budget mit Unity Gateway als Ressourcentyp. Wählen Sie Schwellenwerte für Ihr Team:

Schwellenwert Was sie steuert
Shared Gesamtmonatliche Ausgaben der Nutzer im Budgetbereich.
Pro Benutzer Tagesausgaben, monatlichen Ausgaben oder beides für jeden einzelnen Nutzer.
Benutzerspezifische Überschreibung Ein höheres tägliches oder monatliches Kontingent für bestimmte Nutzer oder Gruppen.

Wählen Sie für jeden gemeinsamen Schwellenwert und für jeden Zeitraum der Pro-User-Schwellenwerte eine oder mehrere von "E-Mail senden", "Nutzung blockieren" und "Webhook auslösen". E-Mails benachrichtigen die konfigurierten Empfänger. Das Blockieren verhindert weitere Gateway-Anfragen, bis der Zeitraum des Schwellenwerts zurückgesetzt wird oder ein Administrator den Schwellenwert erhöht. Tägliche Schwellenwerte werden um 00:00 UTC zurückgesetzt.

Wenn Ihr Team externe Modellanbieter verwendet, aktivieren Sie die Vorschau „Externe Modellausgaben in Budgets“ und wählen Sie „Externe Modellanbieter einschließen“. 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.

Details zur Einrichtung und zum Geltungsbereich finden Sie unter Budgets und Ausgabenlimits für Unity Gateway festlegen.

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

Dies legt Claude Sonnet 5.5 als Standardeinstellung für Claude Code fest. 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-5-5",
    "default_opus_model": "system.ai.claude-opus-4-8",
    "default_sonnet_model": "system.ai.claude-sonnet-5-5",
    "default_haiku_model": "system.ai.claude-haiku-5-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. Bei einer sources Liste muss jeder Standard ein bestimmtes Modell sein, das von einem sources Eintrag erfasst wird, entweder direkt aufgeführt oder durch eine Wildcard abgeglichen.

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-5-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 5.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. Bei einer sources Liste muss das empfohlene Modell ein bestimmtes Modell sein, das ein sources Eintrag enthält, entweder direkt aufgeführt oder durch eine Wildcard abgestimmt. 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. Für GitHub Copilot gelten Empfehlungen für Copilot CLI-Sitzungen, die mit ug copilot gestartet wurden, nicht für Copilot in Visual Studio Code.

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 die Ausführung von Open-Source-Modellen, wie system.ai.glm-5-3, mit Coding-Agenten über Unity Gateway. Open-Source-Modelle können die Kosten pro Token für routinemäßige Codierungsaufgaben erheblich senken. Setze in deiner Konfiguration ein Open-Source-Modell als Standard eines Agenten oder lass die Entwickler eines in der Modellauswahl auswählen.

Anweisungen zur Modellauswahl und Setup-Beispiele finden Sie unter Modelle auswählen. Um zu sehen, welche Agenten offene Modelle unterstützen, siehe Unterstützte Coding- und Work-Agents.

Verstehen Sie Smart Routing

Important

Smart Routing ist noch in der Beta-Phase. Ein Kontoadministrator muss die Vorschau des Enhanced Unity Gateway über die Vorschauseiten der Kontokonsole aktivieren. Siehe Manage Azure Databricks Previews.

Mit eingeschaltetem Smart Routing übergeben Coding-Agenten Aufgaben an Subagents. Smart Routing wählt das kostengünstigste Modell aus, das die Aufgabe jedes Subagents bewältigen kann, sodass für jede Aufgabe ein anderes Modell verwendet werden kann. Die Hauptsitzung läuft auf den Standard- oder Smart-Standard-Einstellungen des Teams. Smart Routing funktioniert mit Claude Code. Smart Routing für Codex ist in der Unity Gateway CLI pausiert. GitHub Copilot unterstützt kein Smart Routing. Mit der Unity Gateway Managed Configuration-Beta kann Smart Routing auch externe Modelle über einen Modellanbieter-Dienst auswählen. Siehe Modellquellen für jeden Agenten 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 claudestarten, wendet die CLI Smart Routing automatisch an. Entwickler können es für einen Launch mit --disable-smart-routing ausschalten. 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. Zum Messen von Einsparungen siehe die Registerkarte Smart Routing.

Einschränkungen des Smart Routing

  • Mit einer statischen models.model_services Liste unterstützt Smart Routing nur Einträge, die mit system.ai.beginnen. Wenn Sie die Unity Gateway Managed Configuration Beta verwenden, unterstützt Smart Routing ebenfalls eine model_provider_service und eine models.sources Liste, sodass es zu externen Modellen hinter einem Modellanbieter-Service weitergeleitet werden kann. Zur Einrichtung siehe Modellquellen für jeden Agenten auswählen.
  • Sie können Smart Routing nicht mit einem unity_catalog_locationaktivieren.
  • Mit sources, muss jeder Modelldienst in der Liste auf genau ein Modell über alle seine Ziele hinweg auflösen, einschließlich Fallback-Ziele.
  • In einer sources Liste muss eine Wildcard das gesamte letzte Segment sein. Ein teilweises Muster wie system.ai.claude-* wird abgelehnt.
  • Wenn zwei Einträge in einer sources Liste auf dasselbe Modell aufgelöst werden, verwendet Smart Routing nur den ersten Eintrag in Listenreihenfolge und ignoriert spätere Duplikate.
  • 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