Контролируйте расходы

Контролируйте, сколько ваша команда тратит на программирование агентов в Unity Gateway. Устанавливайте бюджеты, выбирайте модели, балансирующие стоимость и возможности, и используйте Smart Routing для оптимизации выбора моделей.

Настройка бюджетов

Создайте ежемесячный бюджет с типом ресурса Unity Gateway. Выбирайте пороги для вашей команды:

Порог Что он контролирует
Shared Общие расходы всех пользователей в рамках бюджета.
Для каждого пользователя Платите за каждого отдельного пользователя.
Переопределение для пользователя Более высокий лимит для конкретных пользователей или групп.

Для каждого общего порога или порога для отдельного пользователя выберите «Отправить оповещение», «Блокировать использование» или оба варианта. Оповещения уведомляют настроенных получателей. Блокировка предотвращает дальнейшие запросы на шлюзы до сброса бюджета или повышения порогового порога администратором.

Если ваша команда использует внешние поставщики моделей, включите предпросмотр External Model Spend in Budgets и выберите Включить использование внешней модели. Оценочные внешние расходы затем идут в счёт тех же пороговых значений.

Контроль бюджета использует оценки, близкие к реальному времени. Запросы, которые уже находятся в процессе, могут быть выполнены, поэтому окончательные расходы могут превысить порог. Внешние сметы также могут отличаться от счета поставщика.

Для подробностей настройки и покрытия смотрите раздел «Управление бюджетами для Unity Gateway».

Настройка параметров модели по умолчанию и интеллектуальных значений по умолчанию

Отредактируйте эти настройки в конфигурации вашего агента для кодирования. Объедините поля ниже с существующей конфигурацией, затем сохраните для публикации изменений.

Установите модель по умолчанию

Выбирайте модель, с которой каждый агент начинает для повседневной работы. Для Claude Code добавьте следующее внутрь объекта config в разделе enabled_agents:

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

Это устанавливает Claude Sonnet 4.6 как модель по умолчанию в Claude Code. Выберите модель, поддерживаемую агентом, и убедитесь, что разработчики имеют к ней доступ. ug использует это значение по умолчанию, если нет рекомендации smart-default или явного выбора модели.

Для Claude Code вы также можете сопоставить его семейства моделей Opus, Sonnet, Haiku и Fable с конкретными моделями:

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

Указывайте только те семейные отображения, которые хотите переопределить. Если models используется сервис поставщика модели, используйте идентификаторы модели этого сервиса. В противном случае используйте полные имена сервисов моделей Unity Catalog. При статическом model_services списке все стандартные функции также должны отображаться в этом списке.

Корректируйте рекомендации по мере роста расходов

Important

Умные настройки по умолчанию в бета-версии. Администратор аккаунта должен включить предпросмотр Enhanced Unity Gateway на странице предпросмотра консоли аккаунта. См. статью "Управление предварительными версиями Azure Databricks".

Чтобы порекомендовать другого агента и модель по мере увеличения расходов, добавьте smart_defaults на верхнем уровне существующей конфигурации кодирующего агента:

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

Замените идентификатор бюджета на budget_configuration_id вашего бюджета. Это значение 0.8 означает 80% от применимого порога бюджета. На этом этапе в примере рекомендуется Claude Code с Claude Haiku 4.5. Добавьте рекомендованного агента в enabled_agents и предоставьте разработчикам доступ к модели. Если этот агент использует статический model_services список, включите рекомендуемую модель в этот список. Для нескольких уровней максимальный достигнутый порог определяет рекомендацию.

При запуске ug запускаются рекомендуемые агент и модель. Команда для конкретного агента сохраняет выбранного агента и применяет рекомендацию по модели только в том случае, если она предназначена для этого агента. Явное --model отменяет рекомендацию.

Умные настройки по умолчанию влияют на новые запуски; они не переключают активные сессии и не ограничивают доступ к моделям. Используйте блокировку бюджета, чтобы предотвратить дальнейшие запросы, и разрешения Unity Catalog для ограничения доступа.

Используйте открытые модели

Azure Databricks поддерживает запуск моделей с открытым исходным кодом (OSS), таких как glm-5-2, с агентами для программирования через Unity Gateway. Модели OSS могут значительно сократить стоимость токена для рутинных задач программирования. Установите OSS-модель по умолчанию для агента в вашей конфигурации или пусть разработчики выберут её при запуске.

Примеры запуска и ручная настройка смотрите в разделе Select models. Чтобы увидеть, какие агенты поддерживают открытые модели, см. раздел Поддерживаемые кодовые агенты.

Понимание умной маршрутизации

Smart Routing автоматически выбирает модель с наименьшими затратами, способную справляться с каждой задачей, поэтому разработчикам не нужно выбирать модель для каждого запроса. Это работает с Claude Code и Codex и может выбрать модель, отличную от рекомендованной для команды по умолчанию или по рекомендации smart-default.

Чтобы по умолчанию включить Smart Routing, добавьте smart_routing в существующий config объект каждого поддерживаемого агента:

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

Опубликуйте конфигурацию. Когда разработчики запускают CLI с помощью ug claude или ug codex, Smart Routing применяется автоматически. Чтобы Smart Routing больше не включался по умолчанию, установите для enabled значение false и опубликуйте обновление.

Для настройки и поведения разработчиков смотрите раздел «Выбрать модели» или использовать Smart Routing.

Ограничения умной маршрутизации

  • Умная маршрутизация поддерживает только статический models.model_services список, записи которого начинаются с .system.ai. Вы не можете включить умную маршрутизацию с model_provider_service, unity_catalog_location, пользовательской моделью, внешним провайдером или модельным сервисом вне system.ai.
  • Администраторы рабочих пространств обязаны предоставлять разработчикам доступ к каждой кандидатской модели.
  • Unity Gateway CLI маршрутизирует между моделями внутри жгута. Для маршрутизации через жгуты требуется Omnigent версии 0.8.0 или выше.
  • Нативные сессии Claude Code и Codex, не использующие Unity Gateway CLI, не поддерживают умную маршрутизацию через Unity Gateway.

Проверить расходы

Пересмотрите использование и расходы, чтобы скорректировать бюджеты и выбор моделей. См. Мониторинг активности агента кодирования.

Дополнительные ресурсы

  • Last updated on