Costs & Budgets

Ce que c'est

La comptabilité de bout en bout des dépenses et ses garde-fous — chaque appel de modèle est mesuré, tarifé, attribué et vérifié par rapport aux budgets et aux quotas.

Surface opérateur

• costs_query, costs_summary, costs_by_scope, costs_by_mission, costs_record.
• Vues d'utilisation — usage_summary, models_list.
• budget_status — la vérification du budget restant, exposée aux Agents, utilisée à l'intérieur des phases de mission.

Côté REST, ce sont CostsController / UsageController, et le dashboard affiche les tableaux de bord des coûts et de l'utilisation.

Comment ça marche

Chaque appel écrit un CostTrackingRecord qui capture les tokens d'entrée / de sortie et de lecture / création de cache, les indicateurs de tarification par lot (batch pricing), les unités d'utilisation, la ligne de tarification résolue, le coût dans la devise d'origine et une estimation en USD — attribués par BillingScope à une mission, une conversation, une task et un project. Les fenêtres de quota (QuotaWindow) et le mode de facturation effectif permettent de suivre côte à côte l'usage par abonnement et l'usage à l'usage mesuré (metered), y compris un coût « théorique » pour les appels sous abonnement. Ces enregistrements se cumulent dans les totaux de tokens / coûts de la mission ainsi que dans les vérifications de budget que les Agents consultent avant d'entreprendre un travail coûteux (voir l'enveloppe de budget par tick dans le guide Agents).