# Tableau de bord d'utilisation

> Où lire ce que vos agents ont dépensé : le total des jetons, les modèles et les agents qui les ont consommés, ce qu'il reste du quota de votre offre, et l'utilisation d'une conversation précise.

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.

## Quand l'utiliser

Ouvrez-le quand le badge de jetons du tableau [Activité](/fr/docs/work/activity/) est plus élevé que prévu, avant de changer le modèle d'une [routine](/fr/docs/automate/routines/), 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](/fr/docs/account/plans-and-usage/). Cette page explique comment lire les chiffres.

## Y accéder

<Steps>

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.

</Steps>

## Vue d'ensemble

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

| Tuile | Ce qu'elle indique |
| --- | --- |
| **Total des jetons** | Tout ce qui a été envoyé et reçu sur la période |
| **Requêtes** | Le nombre d'appels de modèle que cela a représenté |
| **Jours actifs** | Les jours de la période avec une utilisation |
| **Série en cours** | Les 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'utilisation** | Les 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](/fr/docs/work/runs/) : 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.

## Modèles et agents

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](/fr/docs/build/models/).
- **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.

<Aside type="note" title="« Non attribué » n'est pas un bug">
  L'onglet Agents comporte une ligne **Non attribué** pour l'utilisation qui ne peut pas
  être imputée à un agent : les appels au niveau du compte, y compris les modèles que vous
  appelez directement via l'[API LLM](/fr/docs/build/llm-api/). C'est une dépense bien réelle,
  simplement sans agent auquel la rattacher. L'onglet Sources la détaille.
</Aside>

## Sources

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](/fr/docs/build/agent-api/).
- **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](/fr/docs/build/llm-api/).

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.

## Calcul

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.

## Un agent en détail

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](/fr/docs/build/analytics/).

## L'utilisation d'une conversation

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.

<Aside type="note" title="Deux chiffres différents, tous deux exacts">
  La carte `/usage` compte ce que la conversation a *dépensé jusqu'ici*. Le panneau de la
  [fenêtre de contexte](/fr/docs/work/context-window/) compte ce qui est *chargé dans le modèle en
  ce moment*. Ce sont deux axes différents : ils ne concorderont pas.
</Aside>

## Limites

- 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é](/fr/docs/account/bring-your-own-key/) 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.

## Voir aussi

<CardGrid>
  <LinkCard
    title="Offres et utilisation"
    href="/fr/docs/account/plans-and-usage/"
    description="Ce qui consomme le quota, et comment fonctionne la fenêtre hebdomadaire."
  />
  <LinkCard
    title="Choisir un modèle"
    href="/fr/docs/build/models/"
    description="La décision que l'onglet Modèles est là pour éclairer."
  />
  <LinkCard
    title="Utiliser votre propre clé"
    href="/fr/docs/account/bring-your-own-key/"
    description="Pourquoi certaines exécutions n'apparaissent jamais ici."
  />
  <LinkCard
    title="Activité"
    href="/fr/docs/work/activity/"
    description="Le tableau dont le badge de jetons mène ici."
  />
</CardGrid>