Rapports, usage et coûts

Comprendre la consommation

Chaque appel d'un agent au modèle est inscrit dans le registre de consommation, avec ses jetons et, quand c'est possible, son coût. La plateforme ne transforme jamais une valeur inconnue en zéro : cette page explique comment lire chaque état.

Qui peut le faire : tout membre du projet consulte la consommation de ses projets. L'Administrateur voit celle de toute l'organisation.

Les jetons#

Un jeton (token) est l'unité de facturation du fournisseur de modèles. Chaque appel compte :

  • les jetons en entrée, y compris les jetons servis depuis le cache du fournisseur ;
  • les jetons en sortie, y compris les jetons de raisonnement ;
  • le total.

Avant chaque appel, la plateforme réserve une quantité prudente de jetons sur le budget. La réponse du fournisseur établit ensuite l'usage réel, et la réserve est libérée.

Trois états à ne jamais confondre#

ÉtatDéfinitionEffet sur le budget
Usage inconnuL'appel a eu lieu, mais le fournisseur n'a pas confirmé les jetons consommés.La réserve reste engagée ; aucun nouvel appel n'est permis pour cette issue.
Consommation nulle confirméeLe fournisseur a confirmé zéro jeton.Aucune consommation.
Reprise réutiliséeÉtape reprise sans nouvel appel, gratuite et comptée à part.Aucune consommation.

Un usage inconnu survient par exemple quand un appel est interrompu (arrêt du worker, coupure réseau) avant la réponse. L'étape correspondante est Indéterminé et n'est pas relancée automatiquement.

Appel non chiffré#

Un appel peut avoir des jetons connus sans coût connu. Il est alors non chiffré. Cela arrive quand aucun tarif ne correspond au modèle à la date de l'appel, quand le tarif du cache manque, quand le modèle réellement utilisé diffère du modèle configuré, ou quand le détail d'usage est insuffisant.

Les tarifs figés#

L'exploitant configure un catalogue de tarifs contractuels : prix par million de jetons en entrée, en entrée cachée et en sortie, avec une devise et une date d'effet. Voir Variables d'environnement.

Au moment de la réservation, le tarif en vigueur est figé dans l'entrée du registre, avec sa provenance. Un tarif publié plus tard ne modifie jamais une entrée déjà enregistrée. Les montants sont calculés exactement et restent séparés par devise : la plateforme ne convertit pas les devises entre elles.

Les montants connus sont des estimations issues des volumes et du contrat configuré. Ils ne remplacent pas la facture du fournisseur.

Lire l'onglet Consommation d'une exécution#

Le détail d'une exécution propose l'onglet Consommation. La carte Usage par étape affiche une ligne par appel :

AffichageSignification
12 480 jetons · 10 200 en entrée · 2 280 en sortieUsage connu ; la ligne suivante détaille Cache et Raisonnement (« inconnu » si le fournisseur ne les donne pas)
Appel en coursRéservation posée, réponse attendue
Usage inconnuVoir le tableau ci-dessus
Réutilisée · aucun nouvel appelReprise réutilisée

À droite, le coût : un montant suivi de sa devise, Gratuite pour une reprise réutilisée, ou Coût inconnu. Sans appel, la carte indique « Aucun appel enregistré. ».

La carte Budgets est décrite dans Budgets et plafonds.

Maintenance réelle et banc d'essai#

Les appels du banc d'essai en mesure réelle sont classés dans la catégorie Banc d'essai, séparée de la Maintenance réelle. Ils n'apparaissent jamais dans les totaux de maintenance. Les simulations du banc ne créent aucune entrée.

Ce que les rapports clients ne montrent pas#

Les jetons et les coûts n'apparaissent jamais dans les rapports PDF. Ils restent dans la plateforme, sur les écrans de consommation et dans les exports CSV.

Pour continuer#

Budgets et plafonds