Résoudre les problèmes liés à Gemini Enterprise Agent Platform

Cette page est le point de départ pour résoudre les problèmes liés à Gemini Enterprise Agent Platform. Utilisez-le pour diagnostiquer une erreur, rechercher une erreur spécifique, trouver le guide correspondant à votre tâche ou obtenir de l'aide.

Diagnostiquer une erreur

Avant de rechercher une solution spécifique, rassemblez les informations suivantes :

Lire l'erreur

Notez le code d'état, tel que 400 ou 429, ainsi que le texte exact du message. Vous pouvez les rechercher dans le catalogue d'erreurs.

Vous pouvez également identifier l'échec spécifique à partir d'une raison lisible par machine, d'un lien vers la documentation ou d'une vue de journal préfiltrée, si ceux-ci sont présents dans le message d'erreur.

Rechercher les journaux

Pour rechercher et filtrer les journaux d'erreurs de l'agent, utilisez l'explorateur de journaux, définissez Type de ressource sur Vertex AI Reasoning Engine, puis sélectionnez la valeur Conteneur de ressources correspondante (le numéro de votre projet) et la valeur ID du moteur de raisonnement.

Vérifier les quotas et l'état du service

Les erreurs qui s'affichent par intermittence ou qui ont commencé sans que vous ayez apporté de modifications sont souvent dues à un quota ou à un incident en cours :

Catalogue d'erreurs

Recherchez l'erreur que vous avez reçue dans le tableau suivant. Si votre erreur ne figure pas dans la liste, utilisez les guides de dépannage pour la tâche que vous essayiez d'effectuer.

Code ou message d'état Solution
ImportError: cannot import name 'reasoning_engines', ImportError: cannot import name 'agent_engines' Version obsolète du SDK Agent Platform pour Python
401 Context-Aware Access requirements are not met, 401 Request had invalid authentication credentials Erreurs d'autorisation 401
ValueError: Cannot get the Candidate text Erreurs de génération de contenu
failed to start and cannot serve traffic, lors de votre premier déploiement de conteneur personnalisé (BYOC) dans une région Erreur de première création de BYOC
failed to start and cannot serve traffic ou Request is prohibited by organization's policy, dans un périmètre VPC Service Controls Erreurs de non-respect de VPC-SC
429, RESOURCE_EXHAUSTED Erreurs "Ressource épuisée" ou "Limite de fréquence"
429, RESOURCE_EXHAUSTED, at capacity Région temporairement à pleine capacité
429, RESOURCE_EXHAUSTED, max_instances Le nombre maximal d'instances dépasse la limite régionale
500 Erreur interne du serveur à partir d'un modèle prédéfini Erreurs de modèle prédéfini
Conflits de version cloudpickle ou pydantic lors de la sérialisation de votre agent Erreurs de sérialisation
NotFound: 404 Can not copy from "gs://..." Le sous-répertoire du bucket Cloud Storage n'est pas créé
iam.serviceAccounts.actAs refusé, serveur de métadonnées indisponible Erreurs liées aux comptes de service personnalisés
400, INVALID_ARGUMENT, REASONING_ENGINE_SECRET_ACCESS_DENIED, referenced by spec.deployment_spec.secret_env Erreurs d'accès à Secret Manager
InvalidArgument: 400 Provided filter is not valid Erreur lors du filtrage de la liste des agents
google.api_core.exceptions.Unknown: None, Failed to convert project number to project ID, au démarrage Erreurs lors du démarrage d'Agent Runtime
403 Forbidden sur une requête sortante Erreurs 403 (Accès interdit)
Échecs de validation de certificat atteignant une destination CA autosignée ou privée Échec de la connexion aux destinations autosignées ou aux destinations d'autorité de certification privée
Échecs de handshake TLS à partir d'un agent de conteneur personnalisé (BYOC) L'agent déployé avec un conteneur personnalisé (BYOC) ne parvient pas à se connecter
Échecs de création de bac à sable Problèmes de création de bac à sable
Délai d'exécution de code dépassé, échecs d'E/S de fichier dans un bac à sable Problèmes d'exécution de code
RuntimeError: Failed to generate memory ou aucun souvenir renvoyé après une session Aucun souvenir n'a été généré

Guides de dépannage

Si vous ne disposez pas d'un message d'erreur spécifique ou si votre erreur ne figure pas dans le catalogue d'erreurs, consultez le tableau suivant pour trouver le guide correspondant à votre tâche :

Tâche Guide
Installer le SDK Agent Platform et configurer votre environnement Configurer l'environnement d'exécution de l'agent
Créer un agent Créer un agent
Déployer un agent dans Agent Runtime Déploiement de l'agent
Appeler un service externe depuis un agent Connectivité d'Agent Gateway
Lister, mettre à jour ou supprimer un agent déployé Gérer les agents déployés
Exécuter du code dans un bac à sable Exécution de code
Générer ou récupérer des informations mémorisées Agent Platform Memory Bank
Mise en service d'un modèle ou dépassement d'un quota de modèle Résoudre les problèmes liés aux services de machine learning

Obtenir de l'aide

Si les guides sur cette page ne résolvent pas votre problème, consultez Obtenir de l'aide pour les agents pour en savoir plus sur les forfaits d'assistance, les forums de la communauté et le signalement de bugs. Pour toute question concernant la facturation, consultez Questions sur la facturation.

Si vous signalez un bug, fournissez les informations suivantes :

  • Code d'état
  • Message d'erreur
  • (Facultatif) Commentaires si le message d'erreur est incorrect, trompeur ou non exploitable.