Cette page est le point de départ pour résoudre les problèmes liés à Gemini Enterprise Agent Platform. Elle vous permet de diagnostiquer une erreur, de rechercher une erreur spécifique, de trouver le guide correspondant à votre tâche, ou d'obtenir de l'aide.
Diagnostiquer une erreur
Avant de rechercher une solution 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 les rechercher dans le catalogue d'erreurs.
Vous pouvez également identifier l'échec spécifique à partir d'une raison lisible par une machine, d'un lien vers la documentation ou d'une vue de journal préfiltrée, si ces éléments 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 Resource type (Type de ressource) sur Vertex AI Reasoning Engine (Moteur de raisonnement Vertex AI), puis sélectionnez la valeur Resource container (Conteneur de ressources) correspondante (le numéro de votre projet) et la valeur Reasoning engine ID (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 que vous ayez effectué de modifications sont souvent dues à un quota ou à un incident en cours :
- Comparez votre utilisation aux quotas et aux limites du système.
- Consultez Google Cloud Service Health pour connaître les incidents en cours dans votre région.
Catalogue d'erreurs
Recherchez l'erreur que vous avez reçue dans le tableau suivant. Si votre erreur n'est pas répertoriée, consultez 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 du premier déploiement d'un conteneur personnalisé (BYOC) dans une région |
Erreur de création BYOC lors de la première utilisation |
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 violation VPC-SC |
429, RESOURCE_EXHAUSTED
|
Erreurs de limite de débit ou de ressources épuisées |
Erreur de serveur interne 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 non disponible |
Erreurs de compte de service personnalisé |
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 lors de l'accès à une destination CA privée ou auto-signée | Échec de la connexion aux destinations CA privées ou auto-signées |
| Échecs de handshake TLS à partir 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 |
| Délai d'exécution de code expiré, échecs d'E/S de fichier dans un bac à sable | Problèmes d'exécution de code |
RuntimeError: Failed to generate memoryou aucune mémoire renvoyée après une session |
Aucune mémoire n'a été générée |
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 obtenir 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 d'un agent |
| Appeler un service externe à partir d'un agent | Connectivité de la passerelle de l'agent |
| Lister, modifier 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 mémoires | Agent Platform Memory Bank |
| Diffuser un modèle ou atteindre un quota de modèle | Résoudre les problèmes liés aux services de machine learning |
Obtenir de l'aide
Si les guides de cette page ne résolvent pas votre problème, consultez Obtenir de l'aide pour les agents pour obtenir des informations sur les packages d'assistance, les forums de la communauté et le signalement de bugs. Si vous avez des questions, consultez la page 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.