Aller au contenu

Tableau de bord d'utilisation

Afficher en Markdown

Le tableau de bord d’utilisation retrace ce que vos agents ont dépensé : les jetons, dans le temps, ventilés par modèle et par agent.

Ouvrez-le quand le badge de jetons du tableau Activité est plus élevé que prévu, avant de changer le modèle d’une routine, ou en début de semaine pour voir où est passée la semaine précédente.

Pour savoir ce qui est comptabilisé et comment fonctionne le quota, lisez d’abord Offres et utilisation. Cette page explique comment lire les chiffres.

  1. Ouvrez l’onglet Utilisation de l’écran d’accueil, ou sélectionnez le badge de jetons dans l’en-tête Activité.

  2. Choisissez une période. 7 jours, 30 jours ou 3 mois. La période modifie les tuiles et les graphiques ; la carte d’activité annuelle couvre toujours l’année en cours.

  3. Passez d’un onglet à l’autre parmi les quatre : Vue d’ensemble, Modèles, Agents, Calcul.

Les tuiles du haut répondent à « combien, à quelle fréquence et avec quoi » :

TuileCe qu’elle indique
Total des jetonsTout ce qui a été envoyé et reçu sur la période
RequêtesLe nombre d’appels de modèle que cela a représenté
Jours actifsLes jours de la période avec une utilisation
Série en coursLes jours consécutifs d’utilisation, avec votre record en indication
Modèle le plus utiliséLe modèle qui a représenté le plus de jetons
Crédits d’utilisationLes dépenses de la semaine, en crédits. La tuile indique le taux de conversion appliqué

En dessous, Quota de l’offre est l’indicateur à surveiller : une barre montre la part du quota actuel déjà consommée, et un message clair s’affiche quand il est épuisé. C’est le même chiffre que le service vérifie avant de lancer une exécution : quand la barre est pleine, les exécutions s’arrêtent.

Activité quotidienne est une carte sur un an, une case par jour, plus foncée les jours où vous avez consommé davantage. C’est le moyen le plus rapide de repérer une routine qui s’est mise à dépenser chaque jour sans que vous le remarquiez.

Les deux onglets ont la même structure : un graphique quotidien en haut, une ventilation en dessous.

  • Modèles : les modèles vers lesquels sont allés les jetons. C’est le plus gros levier sur le coût ; c’est donc généralement ici que commence la décision de changer de modèle. Voir Choisir un modèle.
  • Agents : les agents qui ont dépensé, et les modèles utilisés par chacun. Un agent chargé de nombreuses routines apparaît ici bien avant que vous ne le remarquiez ailleurs.

Dans les deux, la légende sert de filtre : masquez une série pour lire le reste sans elle, et Tout afficher les fait toutes réapparaître. Les lignes pour lesquelles le graphique manque de place sont regroupées dans une entrée « autres » au lieu d’être supprimées.

L’onglet Sources répartit les mêmes jetons selon leur provenance :

  • Agents : les exécutions d’agents lancées depuis les conversations web, les routines et les canaux.
  • API d’agent : les agents appelés avec une clé API via l’API d’agent.
  • endue Live : les conversations que des visiteurs ont eues avec votre agent sur endue Live. Ces conversations comptent dans l’utilisation du propriétaire de l’agent.
  • API LLM : les modèles appelés directement avec une clé API via l’API LLM.

Chaque ligne affiche ses jetons, sa part et ses requêtes, avec en dessous les modèles utilisés. Ici aussi, la légende sert de filtre. Les appels à l’API LLM sont payés avec les crédits achetés et promotionnels, tandis que les exécutions d’agents, de l’API d’agent et d’endue Live puisent dans le quota de votre offre : c’est donc l’onglet à ouvrir quand un solde de crédits bouge sans qu’aucun agent ne l’explique.

Les sessions de navigateur, le stockage de l’espace de travail, le traitement des médias et le stockage des livrables sont listés ici, mais pas encore mesurés. L’onglet l’indique sur chaque ligne.

Lisez les lignes vides comme « pas encore instrumenté », et non comme « zéro ». Rien dans cet onglet n’affirme qu’une ressource est gratuite.

Dépliez une ligne de l’onglet Agents pour trouver Ouvrir dans Studio à la fin. Le canevas de cet agent s’ouvre sur l’onglet Utilisation, pour la même période : vous y voyez les conversations et les crédits par source et par point d’entrée (clé API ou connexion de canal). Voir Statistiques.

Le tableau de bord fonctionne au niveau du compte. Pour un seul fil, tapez /usage dans la zone de saisie de cette conversation : une carte affiche les jetons d’entrée et de sortie, la part mise en cache, le total pondéré, les crédits et les modèles impliqués, avec un lien vers le tableau de bord.

Cette carte est un affichage local, pas un message : elle n’apparaît pas dans l’historique de la conversation et disparaît au rechargement de la page.

  • L’utilisation est mesurée par compte. La vue par agent ventile ce même total ; ce n’est pas un quota distinct.
  • Les chiffres sont consolidés peu après une exécution : la plus récente peut donc manquer pendant un court moment.
  • Les exécutions faites avec votre propre clé ne sont pas enregistrées ici. Une conversation qui n’a utilisé que votre clé apparaît comme « aucune utilisation enregistrée », ce qui est exact pour le registre d’endue et ne dit rien de ce que votre fournisseur vous a facturé.
  • L’agrégation par agent et par source n’est pas disponible dans tous les environnements. Dans ce cas, l’onglet l’indique au lieu d’afficher zéro.
  • L’onglet Calcul est une liste de ressources, pas une mesure.