Cette page explique comment résoudre les problèmes liés au registre d'agents.
Quota de débit d'API dépassé
Ce problème peut se produire si vous interagissez avec l'API Agent Registry ou si vous parcourez rapidement Agent Registry dans la console Google Cloud :
429 Too Many Requests
Pour résoudre ce problème, implémentez un intervalle exponentiel entre les tentatives dans vos clients API afin de gérer les taux de requêtes. L'API Agent Registry dispose d'un quota de débit par défaut de 1 200 requêtes par minute au niveau mondial et par région.
Si vous rencontrez une limitation du débit lorsque vous changez d'onglet dans la console Google Cloud , patientez quelques instants et réessayez. Si votre cas d'utilisation programmatique nécessite des limites plus élevées, demandez une augmentation du quota pour la métrique RequestsPerMinute.
Erreur de taille de charge utile lors de l'enregistrement manuel
Ce problème peut se produire si vous enregistrez manuellement un agent ou un serveur MCP : l'API rejette la requête avec une erreur indiquant que la charge utile est trop volumineuse.
Pour résoudre ce problème, vérifiez que votre fichier agent-card.json ou toolspec.json ne dépasse pas 10 Ko. La taille du contenu AgentSpec et McpServerSpec est limitée à 10 Ko. Pour respecter cette limite, réduisez vos fichiers JSON, supprimez les espaces inutiles ou condensez les descriptions des outils. Pour en savoir plus, consultez Schémas JSON.
Agents ou serveurs MCP manquants après la création
Ce problème peut se produire si vous créez un agent ou un serveur MCP dans un produit Google Cloud compatible, tel que Google Workspace ou Gemini Enterprise : la ressource n'apparaît pas lorsque vous appelez les API ListAgents ou ListMcpServers.
Pour résoudre ce problème, attendez que la synchronisation en arrière-plan soit terminée. Vos ressources sont mises à jour en temps réel, mais les autres intégrations sont alimentées par des jobs par lot hors connexion exécutés périodiquement. Si votre ressource n'apparaît pas au bout de plusieurs heures, vérifiez les paramètres d'Utilisation des services de votre projet et assurez-vous que l'API concernée est activée.
Les opérations de longue durée semblent bloquées
Vous pouvez rencontrer ce problème si vous déployez des agents ou configurez des liaisons complexes : l'opération prend beaucoup de temps et semble bloquée.
Pour résoudre ce problème, utilisez l'outil MCP get_operation ou le point de terminaison de l'API google.longrunning.Operations.GetOperation pour interroger l'état de l'opération. La création de certains backends d'agents et de MCP nécessite un provisionnement d'infrastructure important, ce qui peut entraîner des opération de longue durée (LRO) pouvant prendre jusqu'à 30 minutes. Configurez les paramètres de délai d'expiration de votre client en tant que résultat et interrogez l'indicateur booléen done pour vérifier que l'opération est terminée.
Résultats vides lors de la récupération des liaisons disponibles
Vous pouvez rencontrer ce problème si vous récupérez les liaisons disponibles pour un fournisseur d'authentification : l'API renvoie une erreur empty array ou une erreur d'accès, même si vous avez vérifié que la liaison existe.
Pour résoudre ce problème, vérifiez que votre principal dispose des autorisations IAM (Identity and Access Management) appropriées sur la ressource AuthProvider cible. L'API applique des vérifications IAM strictes et supprime les objets Binding qui font référence à des fournisseurs d'authentification auxquels l'appelant n'a pas accès. Assurez-vous que votre principal dispose de l'accès requis au fournisseur d'authentification et du rôle roles/agentregistry.viewer dans le projet.