Gestion des quotas
Les coûts de l'IA peuvent croître rapidement sans contrôle. Le système de quotas d'Almirant vous donne les garde-fous nécessaires pour maîtriser les dépenses sans devoir microgérer chaque exécution.
Que sont les quotas ?
Les quotas sont des limites configurables qui définissent ce que votre organisation peut consommer en termes de :
| Métrique | Description |
|---|---|
| Tokens | Quantité maximale de tokens pouvant être traités |
| Coût USD | Dépense maximale en dollars américains |
| Requêtes | Nombre maximal d'appels à l'API du fournisseur |
Vous pouvez configurer des quotas indépendants pour chaque fournisseur IA (OpenAI, Anthropic) et définir différentes limites selon la période.
Types de période
Les quotas sont configurés par période, ce qui vous permet d'établir des limites adaptées à votre budget :
| Type | Description | Cas d'usage |
|---|---|---|
| Quotidien | Se réinitialise toutes les 24 heures à minuit (UTC) | Contrôle précis pour les équipes ayant un usage intensif |
| Hebdomadaire | Se réinitialise tous les lundis à minuit (UTC) | Équilibre entre flexibilité et contrôle |
| Mensuel | Se réinitialise le premier jour de chaque mois | Alignement sur les cycles de facturation |
Nous recommandons de commencer avec des quotas mensuels alignés sur votre budget IA, puis d'ajouter des quotas quotidiens si vous détectez des pics de consommation qui affectent la disponibilité pour toute l'équipe.
Configurer des quotas
Pour configurer les quotas de votre organisation :
- Accédez à Configuracion > Cuotas de IA (ou Quota Management).
- Sélectionnez le fournisseur à configurer.
- Définissez les limites pour chaque type de période :
- Tokens máximos : limite de tokens par période
- Costo máximo USD : limite de dépense en dollars
- Solicitudes máximas : limite d'appels à l'API
- Activez ou désactivez le quota avec le toggle Activo.
- Enregistrez les modifications.
Configuration par fournisseur
Chaque fournisseur peut avoir des configurations indépendantes. Cela est utile lorsque :
- Vous avez des budgets différents attribués à chaque fournisseur.
- Vous souhaitez limiter un fournisseur plus strictement pendant que vous en testez un autre.
- Vous devez contrôler séparément les coûts de modèles premium (comme o1).
Exemple de configuration :
OpenAI:
- Mensuel : 500,000 tokens / $50 USD / 1,000 requêtes
- Quotidien : 50,000 tokens / $10 USD / 200 requêtes
Anthropic:
- Mensuel : 300,000 tokens / $30 USD / 500 requêtes
Système d'alertes
Almirant vous notifie de manière proactive lorsque votre consommation approche des limites configurées. Les alertes se déclenchent aux seuils suivants :
| Type d'alerte | Seuil | Action recommandée |
|---|---|---|
| warning_75 | 75 % de la limite | Surveillez attentivement la consommation |
| warning_80 | 80 % de la limite | Envisagez de réduire les opérations non critiques |
| warning_90 | 90 % de la limite | Préparez une augmentation du quota si nécessaire |
| exceeded | 100 % de la limite | Quota épuisé, nouvelles opérations bloquées |
Recevoir des alertes
Les alertes sont envoyées à :
- Administrateurs de l'organisation : reçoivent toutes les alertes par e-mail.
- Panneau de configuration : les alertes actives apparaissent dans la section des quotas.
- Dashboard : indicateur visuel lorsqu'il y a des alertes en attente.
Reconnaître des alertes
Vous pouvez reconnaître une alerte pour indiquer que vous avez déjà agi :
- Accédez à Configuracion > Cuotas de IA.
- Dans la section Alertas activas, cliquez sur l'alerte.
- Sélectionnez Reconocer pour la marquer comme traitée.
Les alertes reconnues ne s'affichent plus pour la même période, mais une nouvelle alerte sera générée si le seuil suivant est atteint.
Voir l'usage actuel
La page de gestion des quotas affiche un résumé de la consommation actuelle par fournisseur et par période :
| Champ | Description |
|---|---|
| Proveedor | OpenAI ou Anthropic |
| Tipo de periodo | Quotidien, hebdomadaire ou mensuel |
| Tokens usados / maximos | Consommation actuelle par rapport à la limite |
| Costo usado / maximo | Dépense actuelle par rapport à la limite |
| Solicitudes usadas / maximas | Appels actuels par rapport à la limite |
| Porcentaje | Indicateur visuel de la consommation |
| Fin del periodo | Moment où le quota se réinitialise |
Le pourcentage affiché correspond à la métrique la plus élevée parmi les tokens, le coût et les requêtes. Cela garantit que vous voyez l'indicateur le plus restrictif.
Reprise automatique
Lorsqu'une période se termine, les quotas se réinitialisent automatiquement :
- Réinitialisation des compteurs : les compteurs de tokens, de coût et de requêtes reviennent à zéro.
- Déblocage des opérations : les opérations bloquées peuvent reprendre.
- Nettoyage des alertes : les alertes de la période précédente sont archivées.
Aucune action manuelle n'est nécessaire pour renouveler le quota.
Comportement des opérations bloquées
Lorsque le quota est épuisé :
- AI Planning : les nouvelles conversations affichent un message indiquant que le quota est épuisé.
- Agents IA : les jobs restent à l'état
pendinget sont traités automatiquement lorsqu'un quota est disponible. - Jobs en cours d'exécution : ils ne sont pas interrompus, mais ne peuvent pas démarrer de nouveaux appels au fournisseur.
Lorsque le quota est renouvelé, les jobs en attente commencent à être traités dans l'ordre FIFO (premier entré, premier sorti).
Bonnes pratiques
- Configurez des alertes précoces -- Le seuil de 75 % vous laisse le temps de réagir avant d'épuiser le quota.
- Utilisez des quotas quotidiens pour un contrôle précis -- Si votre équipe consomme beaucoup en une journée, un quota quotidien évite de priver le reste de la semaine de service.
- Alignez les quotas mensuels sur la facturation -- Configurez des limites correspondant à votre budget IA mensuel.
- Examinez la répartition par projet -- Identifiez les projets à forte consommation pour optimiser ou ajuster les attentes.
- Réservez une marge pour les urgences -- Ne fixez pas les quotas à 100 % du budget ; laissez une marge de 10 à 15 %.
Outils MCP
Les tools suivants sont disponibles via MCP pour consulter et vérifier les quotas :
| Tool | Description | Paramètres principaux |
|---|---|---|
check_quota | Vérifie si un quota est disponible pour une opération | organizationId, provider, estimatedTokens |
get_quota_usage | Obtient le détail de la consommation par fournisseur et période | organizationId, provider, periodType |
Exemple : vérifier le quota avant une opération
Tool: check_quota
Paramètres :
organizationId: "uuid-de-l-organisation"
provider: "openai"
estimatedTokens: 10000
Réponse lorsqu'un quota est disponible :
{
"available": true,
"provider": "openai",
"remainingTokens": 45000,
"remainingCostUsd": 12.50,
"remainingRequests": 150,
"periodEnd": "2024-02-01T00:00:00Z"
}
Réponse lorsqu'aucun quota n'est disponible :
{
"available": false,
"provider": "openai",
"remainingTokens": 0,
"reason": "exceeded",
"periodEnd": "2024-02-01T00:00:00Z"
}
Exemple : consulter l'usage détaillé
Tool: get_quota_usage
Paramètres :
organizationId: "uuid-de-l-organisation"
provider: "openai"
periodType: "monthly"
Réponse :
{
"provider": "openai",
"periodType": "monthly",
"maxTokens": 500000,
"maxCostUsd": 50.00,
"maxRequests": 1000,
"usedTokens": 125000,
"usedCostUsd": 12.50,
"usedRequests": 250,
"percentTokens": 25,
"percentCost": 25,
"percentRequests": 25,
"periodStart": "2024-01-01T00:00:00Z",
"periodEnd": "2024-02-01T00:00:00Z"
}
Modèle de données
À titre de référence technique, voici les principaux types du système de quotas :
QuotaConfig
| Champ | Type | Description |
|---|---|---|
id | UUID | Identifiant unique de la configuration |
provider | string | Fournisseur IA (openai, anthropic) |
quotaType | QuotaType | Type de période (daily, weekly, monthly) |
maxTokens | number | Limite de tokens |
maxCostUsd | number | Limite de coût en USD |
maxRequests | number | Limite de requêtes |
isActive | boolean | Indique si le quota est actif |
UsageSummaryItem
| Champ | Type | Description |
|---|---|---|
provider | string | Fournisseur IA |
periodType | QuotaType | Type de période |
maxTokens | number | Limite configurée |
usedTokens | number | Tokens consommés |
percentTokens | number | Pourcentage d'utilisation (0-100) |
maxCostUsd | number | Limite de coût |
usedCostUsd | number | Coût consommé |
percentCost | number | Pourcentage de coût |
maxRequests | number | Limite de requêtes |
usedRequests | number | Requêtes effectuées |
percentRequests | number | Pourcentage de requêtes |
periodEnd | DateTime | Fin de la période actuelle |
QuotaAlert
| Champ | Type | Description |
|---|---|---|
id | UUID | Identifiant de l'alerte |
providerQuotaId | UUID | Référence à QuotaConfig |
alertType | AlertType | Type d'alerte (warning_75, warning_80, warning_90, exceeded) |
periodStart | DateTime | Début de la période de l'alerte |
message | string | Message descriptif |
acknowledgedAt | DateTime | Date de reconnaissance (null si non reconnue) |