Ver el uso y la cuota

Dos herramientas de solo lectura responden a cada pregunta de "¿cuánto estoy usando?". Ambas devuelven únicamente metadatos — conteos de tokens y conteos de eventos — y nunca el contenido de la conversación.

Tu posición frente a la cuota

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

Caso de uso — "¿Estoy a punto de quedarme sin cuota?" Compara el total con monthly_token_quota de tenant_info. El exceso se factura por vencimiento, por lo que mostrar "estás al 82% de la cuota de este mes" permite al usuario decidir antes de que le cueste dinero.

Qué está impulsando el costo

usage_stats(group=…) divide los mismos totales. Elige el grupo según la pregunta que estés respondiendo:

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?

Casos de uso a simple vista:

• "Mi factura aumentó este mes — ¿por qué?" → group="day" para encontrar el pico, luego group="agent" para ver de qué agente provino.
• "¿Está un modelo realizando trabajo que uno más barato podría hacer?" → group="model", luego considera update_agent(name, model=…) en los infractores.
• "¿A qué cliente debo hacer upsell / limitar la tasa?" → group="space" o group="user".

Informa de vuelta. Comienza con el único número que importa — "Has utilizado 4,2M de tus 5M de tokens mensuales (84%)" — luego el desglose que lo explica, y enlaza la consola para el panorama completo: https://console.agent4.io/#/usage.