---
title: Budgets et plafonds
description: Le plafond par exécution, le budget de l'issue et de ses reprises, le seuil d'alerte de 80 % et le blocage sur usage inconnu.
---

# Budgets et plafonds

Deux enveloppes de jetons encadrent chaque exécution : un plafond propre à l'exécution et un budget partagé par l'issue et toutes ses reprises. Elles évitent qu'une issue difficile consomme sans limite.

**Qui peut le faire** : tout membre du projet consulte les budgets. Le Responsable règle le budget de l'issue dans la politique du dépôt. L'exploitant règle le plafond par exécution.

## Les deux enveloppes

| Enveloppe | Libellé dans **Consommation** | Réglage | Portée |
| --- | --- | --- | --- |
| Plafond par exécution | **Exécution** | Fixé par l'exploitant pour toute l'instance ; sans valeur, le budget de l'issue s'applique seul | Une tentative |
| Budget de l'issue | **Issue et reprises** | Champ **Nombre maximal de tokens** du dépôt, de 1 à 1 000 000 tokens | L'issue, sa PR et toutes ses reprises |

Le budget de l'issue se règle dans [Surveillance et politique du dépôt](../02-projets-et-depots/05-surveillance-et-politique.md).

## Comment le budget est consommé

1. Avant chaque appel, la plateforme réserve une estimation prudente : taille du message envoyé plus la sortie maximale demandée.
2. Si la réserve dépasse le solde d'une des deux enveloppes, l'appel n'a pas lieu.
3. À la réponse, l'usage réel remplace la réserve.
4. Avant une reprise, la consommation déjà connue de l'issue est déduite.

Les réservations encore en cours, y compris celles d'autres exécutions du même dépôt, sont comptées. L'estimation est prudente mais ne garantit pas le montant facturé.

## Lire la carte Budgets

L'onglet **Consommation** d'une exécution affiche la carte **Budgets** :

```text
Exécution            41 200 / 80 000 jetons
Issue et reprises    83 500 / 100 000 jetons
                     6 000 jetons réservés
                     Seuil de 80 % atteint
```

| Mention | Signification |
| --- | --- |
| `utilisé / plafond jetons` | Jetons connus consommés sur le plafond |
| **N jetons réservés** | Réserve encore engagée (appel en cours ou usage inconnu) |
| **Seuil de 80 % atteint** | L'enveloppe a atteint 80 % ; le franchissement est tracé dans le journal des actions |
| **Solde indéterminé** | Un appel a un usage inconnu : le solde ne peut plus être garanti |
| **Indisponible** | Aucune enveloppe de ce type n'est définie |

## Ce qui se passe au plafond

Quand l'enveloppe ne permet plus le prochain appel, l'exécution s'arrête avec le badge **Refusé** et le motif « L'enveloppe de jetons ne permet pas le prochain appel. ». Rien n'est publié pour cette tentative.

Pour continuer le travail :

- relevez le champ **Nombre maximal de tokens** du dépôt (vérifiez la borne de 1 000 000 tokens), puis relancez à partir d'un agent ;
- ou reformulez l'issue pour réduire le contexte nécessaire.

> [!WARNING]
> Après un usage inconnu, aucune reprise n'est possible pour l'issue, même si le budget semble suffisant. La plateforme préfère bloquer plutôt que risquer un dépassement non mesuré.

## Autres plafonds utiles

| Plafond | Valeur | Où |
| --- | --- | --- |
| Exécutions simultanées par dépôt | De 1 à 10 exécutions | Champ **Nombre maximal d'exécutions** |
| Reprises par issue | 3 | Fixe |
| Reprises automatiques après revue, par PR | 2 | Fixe |
| Plafond par essai du banc d'essai | De 1 000 à 400 000 jetons | Formulaire du banc |
| Budget total d'une évaluation du banc | De 1 à 50 000 000 jetons | Formulaire du banc |

Les budgets du banc d'essai sont séparés de ceux de la maintenance réelle.

L'Administrateur suit aussi l'état des budgets de l'instance sur la page **Exploitation**, voir [Page Exploitation](../06-administration-et-supervision/08-page-exploitation.md).

## Pour continuer

[Page Consommation et export CSV](05-page-consommation-et-export-csv.md)
