Проверка использования и квоты

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

Где вы находитесь относительно квоты

tenant_info()                 # plan + monthly_token_quota (the ceiling)
usage_stats(group="total")    # tokens + events used so far this period

Сценарий использования — «я скоро исчерпаю квоту?» Сравните общее значение с monthly_token_quota из tenant_info. Перерасход оплачивается задним числом, поэтому отображение «вы использовали 82% от месячной квоты» позволяет пользователю принять решение до того, как это обойдется ему в деньги.

Что формирует стоимость

usage_stats(group=…) разбивает эти же общие значения. Выберите группу в зависимости от вопроса, на который вы хотите ответить:

usage_stats(group="agent")    # which agent is busiest / burning the most tokens
usage_stats(group="user")     # which end user is heaviest — spot one runaway account
usage_stats(group="space")    # usage per customer space (multi-tenant fan-out)
usage_stats(group="day")      # trend over time — catch a spike the day it happens
usage_stats(group="model")    # cost mix across models — is an expensive model doing routine work?

Сценарии использования вкратце:

• «Мой счет резко вырос в этом месяце — почему?» → group="day", чтобы найти всплеск, затем group="agent", чтобы увидеть, от какого агента он произошел.
• «Не выполняет ли одна модель работу, которую могла бы сделать более дешевая?» → group="model", затем рассмотрите update_agent(name, model=…) для нарушителей.
• «Какого клиента следует перепродать / ограничить по скорости?» → group="space" или group="user".

Вернитесь с отчетом. Начните с одной цифры, которая имеет значение — «Вы использовали 4,2 млн из ваших 5 млн ежемесячных токенов (84%)» — затем приведите разбивку, которая это объясняет, и дайте ссылку на консоль для полной картины: https://console.agent4.io/#/usage.