Presupuestos

Las llamadas a los modelos se facturan a tus cuentas de proveedor, con tus claves. Budgets te permite limitar cuánto usan los agentes de un espacio de trabajo, para que un agente con mucho tráfico o un bucle descontrolado no genere una factura elevada.

Abre Manage > Budgets. Para ver los presupuestos, se necesita budgets.view; para crearlos, editarlos y borrarlos, se necesita budgets.manage.

Agrega un límite

1. Selecciona Add Limit.
2. Elige el Provider: Anthropic, Google Gemini u OpenAI.
3. Elige un Model o All models para abarcar todos los modelos de ese proveedor.
4. Elige el Period: daily o monthly.
5. Establece un Token limit, un Cost limit (USD) o ambos. El límite se alcanza cuando se alcanza cualquiera de los dos.
6. Elige qué sucede cuando se alcanza:
   • Block: se rechazan las nuevas ejecuciones del agente.
   • Warn only: las ejecuciones continúan y el exceso queda registrado.
7. Deja activado Active y selecciona Create Limit.

Los límites inactivos se conservan, pero no se aplican.

Cómo se cuentan los límites

• Los períodos siguen la hora UTC: un límite diario se restablece a las 00:00 UTC, y uno mensual, el primer día del mes.
• El uso mediante Vertex AI cuenta para su proveedor: Claude en Vertex AI cuenta para Anthropic, y Gemini en Vertex AI, para Google Gemini.
• Un límite para All models suma todos los modelos de ese proveedor. Puedes combinarlo con límites para modelos específicos. Si se alcanza cualquier límite Block que abarque el modelo, la ejecución se bloquea.
• El costo es una estimación de VirtuAI a partir de la cantidad de tokens y una tabla de precios. La cifra oficial es la de la factura de tu proveedor.

Current Period Usage muestra cada límite activo con los tokens y el costo usados hasta el momento en el período, y si su estado es OK o Exceeded.

Cuando se alcanza un límite

VirtuAI verifica los límites antes de cada ejecución de un agente en el chat web, WhatsApp, Google Chat, Telegram, Slack y A2A, y antes de cada ejecución de una evaluación. Con Block, la persona recibe este mensaje en lugar de una respuesta:

The daily usage limit for this agent has been reached. New requests are temporarily blocked. Please contact your workspace administrator.

La versión mensual dice “monthly”. Para desbloquear, aumenta el límite, desactívalo o espera al siguiente período.

Precaución

Un presupuesto es un control de costos, no un tope estricto:

• La verificación ocurre antes de que empiece una ejecución, por lo que una ejecución en curso termina y puede hacer que el uso supere el límite.
• Si la verificación misma falla, se permite la ejecución, de modo que un problema en el sistema de presupuestos nunca deja fuera de servicio a tus agentes.

Si necesitas un tope estricto, establece también límites de gasto en el proveedor.

Historial de uso

Los registros de uso se conservan durante 90 días. Para informes a más largo plazo, usa Analytics o la consola de facturación de tu proveedor.