Le registre d'agents utilise des quotas et des limites système pour maintenir une allocation équitable des ressources, éviter les surcharges de service et vous aider à gérer l'utilisation des ressources.
Les quotas et les limites du système sont similaires, mais diffèrent sur les points suivants :
- Les quotas ont des valeurs par défaut, mais vous pouvez généralement demander des ajustements.
- Les limites système sont des valeurs fixes qui ne peuvent pas être modifiées.
Google Cloud utilise des quotas pour garantir l'équité et réduire les pics d'utilisation et de disponibilité des ressources. Un quota limite la quantité d'une ressourceGoogle Cloud que votre projet Google Cloud peut utiliser. Les quotas s'appliquent à différents types de ressources, y compris les composants matériels, logiciels et réseau. Par exemple, ils peuvent limiter le nombre d'appels d'API à un service, le nombre d'équilibreurs de charge utilisés simultanément par votre projet ou le nombre de projets que vous pouvez créer. Ils protègent la communauté des utilisateurs deGoogle Cloud en empêchant la surcharge des services. Les quotas vous aident également à gérer vos propres ressources Google Cloud .
Le système Cloud Quotas permet d'effectuer les opérations suivantes :
- Surveiller votre consommation de produits et services Google Cloud
- Limiter votre consommation de ces ressources
- Demander des modifications de la valeur du quota et automatiser les ajustements de quota
Dans la plupart des cas, lorsque vous tentez d'utiliser une ressource plus que son quota ne le permet, le système bloque l'accès à la ressource et la tâche que vous essayez d'effectuer échoue.
Les quotas s'appliquent généralement au niveau du projet Google Cloud . Votre utilisation d'une ressource dans un projet n'affecte pas votre quota disponible dans un autre projet. Dans un projet Google Cloud , les quotas sont partagés entre toutes les applications et adresses IP.
Pour en savoir plus, consultez la présentation des quotas Cloud.
Les quotas d'allocation
Les quotas d'allocation limitent la quantité d'une ressource spécifique qu'Agent Registry vous permet d'utiliser à un moment donné. Lorsque vous créez une ressource, votre quota disponible pour cette ressource diminue. Lorsque vous supprimez la ressource, le quota est restauré.
Le tableau suivant liste les quotas d'allocation qui s'appliquent au registre d'agents et la valeur par défaut de chaque quota.
| Quota | Valeur |
|---|---|
| Nombre maximal d'agents par projet | 100 (au niveau mondial et par région) |
| Nombre maximal de serveurs MCP par projet | 100 (au niveau mondial et par région) |
| Nombre maximal de points de terminaison par projet | 100 (au niveau mondial et par région) |
| Nombre maximal de liaisons par projet | 100 (au niveau mondial et par région) |
| Nombre maximal de compétences A2A par projet | 100 (au niveau mondial et par région) |
| Nombre maximal de compétences autonomes par projet et par emplacement | 100 (mondial, multirégional et par région) |
| Nombre maximal de révisions de compétences par projet et par emplacement, partagé entre toutes les compétences de l'emplacement | 500 (mondial, multirégional et par région) |
Les quotas de débit
Les quotas de débit limitent la vitesse à laquelle vous pouvez consommer une ressource. Les quotas de débit par minute sont réinitialisés toutes les minutes. Le tableau suivant liste les quotas de débit qui s'appliquent au registre d'agents et la valeur par défaut de chaque quota.
| Quota | Valeur |
|---|---|
| Regrouper les requêtes API entre les méthodes globales et régionales | 12 000 par minute et par projet (200 RPS) |
| Requêtes API globales | 1 200 par minute et par projet (20 RPS) |
| Requêtes API régionales | 1 200 par minute,par projet et par région (20 RPS) |
| Créer, mettre à jour et supprimer des demandes de compétences et de révisions de compétences | 120 par minute, par projet et par emplacement (2 RPS. Global, multirégional et par région) |
| Requêtes get, list et search pour les compétences et les révisions de compétences | 1 200 par minute,par projet et par emplacement (20 RPS). Global, multirégional et par région) |
Limites du système
Le tableau suivant liste les limites système qui s'appliquent à Agent Registry et la valeur de chaque limite système.
| Limite système | Valeur |
|---|---|
| Longueur du nom à afficher | 63 caractères (services et liaisons) ; 128 caractères (compétences) |
| Longueur de la description | 2 048 caractères |
| Taille du contenu de la spécification de l'agent | 10 Ko |
| Taille du contenu de la spécification du serveur MCP | 10 Ko |
| Taille maximale de la charge utile de la compétence compressée (ZIP) | 1 Mo |
| Taille totale maximale de la charge utile de compétence non compressée pour les compétences analysées | 10 Mo, appliqué lorsque l'analyse est activée |
| Taille maximale d'un fichier non compressé dans la charge utile de la compétence pour les compétences analysées | 1 Mo, appliqué lorsque l'analyse est activée |
| Nombre maximal de compétences ou d'outils A2A par service | 100 |
| Taille maximale de la pagination | 100 |
| Nombre maximal de projets membres par projet de gestion pour le cumul interprojets | 10 000 |
Quotas pour l'A2A agentique et les services en aval
Lorsque vos agents d'orchestration découvrent et appellent des agents Agent2Agent (A2A) ou des outils MCP (Model Context Protocol), Google Cloud évalue la consommation de quota sur trois couches distinctes :
- Quotas de découverte et de gestion du registre : les quotas d'allocation et de débit listés dans ce document ne régissent que les requêtes d'enregistrement, de gestion, de recherche et de recherche de métadonnées envoyées à Agent Registry. Les appels d'agent et d'outil d'exécution ne consomment pas le quota de débit du registre d'agents une fois que votre client a recherché l'URL d'un agent cible ou d'un point de terminaison de serveur MCP.
- Quotas d'exécution de l'agent cible : chaque environnement d'exécution ou service Google Cloudcible applique ses propres quotas de débit. Pour connaître les limites spécifiques à un service, consultez la documentation sur les quotas du service cible ou affichez les quotas spécifiques à l'API.
- Quotas d'API et de jetons par service en aval : lorsqu'un agent A2A appelle des API ou des outils MCP en aval Google Cloud , ces appels consomment les quotas de débit d'API par service du projet de quota ou du projet de ressource facturé pour chaque requête. Les boucles de raisonnement autonomes, les nouvelles tentatives et les sous-agents parallèles peuvent générer un trafic en rafale par rapport aux quotas de projet partagés. Surveillez l'utilisation dans Cloud Quotas et réduisez-la en demandant des valeurs de quota inférieures, comme décrit dans Afficher et gérer les quotas. Pour limiter la consommation de jetons LLM partagés dans le trafic sortant des agents, configurez des règles de gestion des jetons sur Secure Web Proxy et Agent Gateway.
Obtenir les noms des métriques de quota et de limite du système
Les quotas et les limites du système ont deux types de noms : les noms à afficher et les noms de métriques. Les noms à afficher comportent des espaces et des majuscules qui facilitent la lecture par les humains. Les noms de métriques sont plus susceptibles d'être en minuscules et délimités par des traits de soulignement au lieu d'espaces. Le format exact dépend du service.
Les instructions suivantes expliquent comment obtenir les noms des métriques pour les quotas et les limites du système à l'aide de la console Google Cloud ou de la Google Cloud CLI.
Console
Dans la console Google Cloud , accédez à la page IAM et administration > Quotas et limites du système :
Accéder à la page Quotas et limites du système
Le tableau de cette page affiche les quotas et les limites du système qui sont utilisés ou dont les valeurs ont été ajustées, ainsi qu'une entrée de référence pour les autres quotas. L'entrée de référence comporte le mot "default" entre parenthèses à la fin de la liste dans la colonne Nom. Par exemple,
SetIAMPolicy requests per minute per region (default)est l'entrée de référence pour le quotaSetIamPolicyRequestsPerMinutePerProject.Si la colonne Métrique ne s'affiche pas, procédez comme suit.
- Cliquez sur Options d'affichage des colonnes.
- Sélectionnez Metric (Métrique).
- Cliquez sur OK. La colonne Métrique s'affiche dans le tableau.
La colonne Métrique indique les noms des métriques. Pour filtrer les résultats, saisissez un nom ou une valeur de propriété dans le champ situé à côté de Filtrer.
gcloud
Pour obtenir les noms des métriques d'un service Google Cloud à l'aide de la gcloud CLI, exécutez la commande quotas info list. Pour ignorer les lignes qui ne listent pas les noms de métriques, transmettez le résultat à une commande telle que grep avec metric: comme terme de recherche, ou utilisez l'option gcloud CLI --format :
gcloud beta quotas info list --project=PROJECT_ID_OR_NUMBER \
--service=SERVICE_NAME --format="value(metric)"
Remplacez les éléments suivants :
PROJECT_ID_OR_NUMBER: ID ou numéro du projet.SERVICE_NAME: nom du service dont vous souhaitez afficher les métriques de quota. Par exemple, le nom du service Compute Engine estcompute.googleapis.com. Incluez la partiegoogleapis.comdu nom du service.
Demander un ajustement de quota
Pour ajuster la plupart des quotas, utilisez la console Google Cloud . Pour en savoir plus, consultez la section Demander un ajustement de quota.