Presupuestos y costes
Mira cuánto costó cada ejecución, fija presupuestos para la organización, los proyectos, los agentes y las tareas, y qué ocurre al 80 y al 100 %.
Cada ejecución registra su coste. Los presupuestos limitan ese gasto antes de que ocurra, no después: cuando se alcanza un límite, el trabajo se pausa hasta que una persona decide continuar.
De dónde salen los costes
Cada ejecución informa de su proveedor, modelo, tokens y coste. Veyra los suma por agente, tarea, proyecto, rutina y día. Las ejecuciones con un plan de suscripción registran la cuota del plan aparte del uso por token, para que veas ambos.
Nota
Las cifras de Veyra son su propia contabilidad de las ejecuciones. No son la factura de tu proveedor, que puede incluir uso fuera de Veyra.
Consulta tus costes
Abre Costs:
- El resumen compara el gasto del mes con el presupuesto de la organización.
- Los filtros acotan por agente, proyecto, modelo y rango de fechas; la barra de compartir guarda una vista filtrada como enlace.
- Daily charges representa el gasto diario.
- Subscriptions lista las cuentas de cuota fija. Edita un precio que gestiones, vincula dos cuentas que son la misma plaza de pago o deja de seguir una.
- Las pestañas Decisions y Fast responses muestran el coste de esos servicios.
Si no se pudo registrar el coste de una ejecución, el resumen la muestra en run costs unavailable. Retry cost recording vuelve a procesar el uso guardado sin ejecutar de nuevo el agente.
Presupuestos
Los presupuestos se fijan en dólares estadounidenses (la API usa centavos).
| Ámbito | Periodo | Dónde se fija |
|---|---|---|
| Organización | Mes natural (UTC) | Costs › Budgets o la configuración de la organización. |
| Proyecto | Mes natural (UTC) | El Budget del proyecto. |
| Agente | Mes natural (UTC) | La pestaña Budgets del agente. |
| Tarea | Toda la vida de la tarea | El Budget de la tarea, en Details o al crearla. |
Necesitas el permiso Manage budgets (budgets:manage).
Qué pasa al llegar al límite
| Se alcanza | Efecto |
|---|---|
| 80 % | Un aviso. Se pide a los agentes que se centren en lo más importante. |
| 100 % | Un tope estricto. El agente, el proyecto o la tarea se pausa y no inicia nuevas ejecuciones. |
Un tope estricto crea una tarjeta de presupuesto para el Budget owner de la organización. Desde la tarjeta, Raise limit fija un presupuesto mayor y deja que el trabajo continúe; Keep paused lo deja detenido. Un mes nuevo levanta automáticamente los topes mensuales.
Los límites se superponen: el trabajo debe estar dentro de cada presupuesto que le aplica. Subir el presupuesto de un agente no sirve si su proyecto también está en el límite.
Desde la API
# Set an agent's monthly budget to $50
curl -X PATCH "https://intelligence-api.veyra.so/api/agents/$AGENT_ID" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"budgetMonthlyCents": 5000}'
# Spend summary for the organization
curl "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/costs/summary" \
-H "Authorization: Bearer $VEYRA_API_KEY"Consulta Costes y presupuestos en la referencia de la API.