Feuille de calcul du coût complet d'un agent

Mis à jour October 8, 2026 · première publication October 8, 2026

Réponse rapide: Un total de tokens de modèle n'est pas un coût complet d'agent. Une exécution en production peut aussi consommer de la recherche hébergée, de l'exécution de code, du stockage, des relances, des...

Un total de tokens de modèle n'est pas un coût complet d'agent. Une exécution en production peut aussi consommer de la recherche hébergée, de l'exécution de code, du stockage, des relances, des modèles de repli et de la revue humaine. Une feuille de calcul utile rattache chaque charge à un identifiant d'exécution et sépare les frais mesurés du fournisseur des frais généraux alloués et des estimations de main-d'œuvre.

Cette feuille complète le coût par tâche réussie : on assemble d'abord le registre de coûts complet, puis on le divise par les résultats qui ont passé le test de réussite défini. Elle prolonge aussi la facturation séparée des outils pour en faire un enregistrement financier reproductible.

Commencez par une ligne par événement

Utilisez un identifiant de workflow stable pour l'intention de l'utilisateur et un identifiant d'exécution pour chaque tentative. Consignez l'horodatage, l'environnement, l'équipe ou le locataire, le workflow, l'exécution, le fournisseur, le service, l'identifiant de ressource, la quantité, l'unité, la version de la grille tarifaire, la devise et la source de la facture ou de la mesure. Conservez un événement par appel de modèle, appel d'outil, tâche de calcul ou élément de revue. Les relances deviennent ainsi visibles et la finance peut rapprocher les totaux sans deviner quelle opération imbriquée les a générés.

Colonnes de la feuille de calcul

Modèle : fournisseur, modèle, unités d'entrée, de sortie, de cache et de raisonnement lorsqu'elles sont exposées, tarif mesuré et charge directe.
Outils : recherche, récupération, navigateur, exécution de code et autres services mesurés, avec nombre d'appels ou durée d'exécution et charge directe.
Calcul et stockage : durée d'exécution du bac à sable ou du conteneur, temps d'accélérateur ou de CPU, stockage persistant et frais réseau s'ils sont facturés.
Travail de fiabilité : relances, appels de repli, branches abandonnées et exécutions de réparation. Gardez-les dans le coût total de l'exécution même s'ils n'ont produit aucun résultat utile.
Vérification : appels d'évaluateurs et minutes de revue humaine, le coût de main-d'œuvre étant signalé comme une estimation interne et non comme une charge facturée par le fournisseur.
Plateforme partagée : allocations d'orchestration, d'observabilité, de capacité réservée ou de stockage partagé, chacune avec son clé de répartition et sa période.

Calculez séparément le coût direct et le coût complet

Le coût direct d'une exécution est la somme des charges mesurées de modèle, d'outils, de calcul et de stockage attribuées à cette exécution. Le coût complet ajoute la part déclarée des frais généraux de plateforme et de la main-d'œuvre de revue. Utilisez une clé de répartition stable pour les coûts partagés, comme la durée d'exécution mesurée, la capacité réservée ou une allocation documentée par exécution. Publiez la clé et sa fenêtre temporelle ; ne répartissez pas les coûts fixes au nombre de tokens, sauf si les tokens expliquent réellement la consommation de ressources.

Un petit exemple hypothétique clarifie la formule : si une exécution comporte 0,40 $ de frais de modèle, 0,10 $ d'outils, 0,20 $ de calcul en bac à sable et 0,30 $ de coûts alloués de revue et de plateforme, rapportez 0,70 $ en direct et 1,00 $ en coût complet. Ces chiffres n'illustrent que l'arithmétique ; ce ne sont ni un prix de marché ni une référence.

Distinguez les tentatives et les résultats

Comptez chaque tentative dans la dépense, puis qualifiez le workflow final de réussi, échoué, abandonné ou nécessitant une finalisation humaine selon une règle explicite. Rapportez le coût par workflow terminé avec le taux de réussite, le taux de relance et l'effort de revue. Pour une métrique de tâche réussie, utilisez la dépense éligible totale de la période divisée par le nombre de workflows ayant passé le test de réussite. N'excluez pas les exécutions échouées du numérateur et ne comptez pas les étapes intermédiaires de l'agent comme des réussites distinctes.

Rapprochez et gouvernez la feuille de calcul

Rapprochez les totaux d'événements des factures des fournisseurs et des exports de facturation cloud une fois les données d'usage stabilisées. Expliquez séparément les crédits, remises, minimums, événements tardifs et conversions de devises. Conservez la source du prix et sa date d'effet afin de pouvoir recalculer les coûts historiques sans appliquer le tarif d'aujourd'hui à l'usage du mois dernier.

Désignez un responsable pour chaque workflow et définissez un budget par exécution, un budget agrégé par période et une voie d'escalade. Lorsqu'un workflow dépasse son budget, consignez la raison et indiquez s'il a été autorisé à continuer. Pour les modèles d'application à l'exécution, voir les trois budgets des agents autonomes.

FAQ

Que doit contenir une feuille de calcul des coûts d'agent ?

Consignez l'usage du modèle, les outils facturés, le calcul, le stockage, les relances, les appels de repli, la vérification, ainsi que, identifiées séparément, les allocations de plateforme partagée et les estimations de main-d'œuvre.

Faut-il inclure les exécutions d'agent échouées dans le coût par tâche ?

Incluez leur dépense dans le total. Rapportez le nombre de workflows réussis selon une règle de réussite déclarée pour que les échecs restent visibles dans l'économie unitaire.

Comment éviter de compter deux fois les coûts de plateforme partagée ?

Gardez les charges directes rattachées à leur événement, allouez les coûts partagés dans un registre distinct avec une seule clé de répartition publiée, et rapprochez le total alloué de l'enveloppe de coûts de la plateforme.