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 un correctif spécifique, collectez 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 rechercher les deux dans le catalogue d'erreurs.

Vous pouvez également identifier l'échec spécifique à partir d'un motif lisible par machine, d'un lien vers la documentation ou d'une vue de journal préfiltrée, s'ils 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 le type de ressource sur moteur de raisonnement Vertex AI, puis sélectionnez la valeur de conteneur de ressources correspondante (votre numéro de projet) et la valeur d'ID du moteur de raisonnement.

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

Les erreurs qui apparaissent par intermittence ou qui ont commencé sans modification de votre part 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 n'est pas listée, utilisez les guides de dépannage pour la tâche que vous essayiez d'effectuer.

Code d'état ou message 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 lors de la première création 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 de ressource épuisée ou de limitation du débit
429, RESOURCE_EXHAUSTED, at capacity La région a temporairement atteint sa capacité maximale
429, RESOURCE_EXHAUSTED, max_instances Le nombre maximal d'instances dépasse la limite régionale
Erreur interne du serveur 500 à 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
504, DEADLINE_EXCEEDED, REASONING_ENGINE_BUILD_TIMEOUT La création de l'image de conteneur a dépassé le délai
504, DEADLINE_EXCEEDED, REASONING_ENGINE_CONTAINER_START_TIMEOUT Le conteneur n'a pas démarré à temps
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, pendant le 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 d'autorité de certification autosignée ou privée Échec de la connexion des destinations d'autorités de certification autosignées ou privées
Échecs de handshake TLS d'un agent de conteneur personnalisé (BYOC) Échec de la connexion de l'agent déployé avec un conteneur personnalisé (BYOC)
Échecs de création de bac à sable Problèmes de création de bac à sable
Expiration du délai d'exécution de code, échecs d'E/S de fichiers dans un bac à sable Problèmes d'exécution de code
RuntimeError: Failed to generate memory, ou aucun souvenir n'est renvoyé après une session Aucun souvenir n'a été généré

Guides de dépannage

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

Tâche Guide
Installer le SDK Agent Platform et configurer votre environnement Configuration de l'environnement Agent Runtime
Créer un agent Créer un agent
Déployer un agent sur 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ération ou récupération des informations mémorisées Agent Platform Memory Bank
Mise en service d'un modèle ou atteinte d'un quota de modèle Dépannage des services de machine learning

Obtenir de l'aide

Si les guides de cette page ne permettent pas de résoudre votre problème, consultez Obtenir de l'aide pour les agents pour en savoir plus sur les packages d'assistance, les forums de la communauté et les rapports de bug. 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.