Résoudre les problèmes d'exécution de code

Cette section présente les problèmes courants et leurs solutions lorsque vous travaillez avec l'exécution de code Agent Engine.

Problèmes liés à la création de bacs à sable

  • Erreur d'autorisation : si vous rencontrez des erreurs lors de la création d'un bac à sable, assurez-vous que votre projet Google Cloud dispose du rôle IAM (Identity and Access Management) (roles/aiplatform.user) "Utilisateur Vertex AI".

  • ID ou emplacement de projet non valides : vérifiez que les variables PROJECT_ID et LOCATION utilisées dans votre code sont correctes et compatibles. Pour obtenir la liste des régions compatibles, consultez Régions compatibles.

  • Moteur d'agent non créé : avant de créer un bac à sable, vérifiez que l'instance du moteur d'agent a bien été créée. La méthode agent_engine.create() doit se terminer sans erreur.

Problèmes d'exécution du code

  • Erreurs de code : examinez la sortie stderr de la réponse execute_code pour identifier les erreurs de syntaxe, les exceptions d'exécution ou les failles logiques dans votre code.

  • Problèmes d'E/S de fichiers :

    • Fichier introuvable : assurez-vous que tous les fichiers d'entrée spécifiés dans le tableau files de votre input_data sont correctement référencés dans votre code. Votre code est exécuté dans le même dossier que les fichiers et ne peut pas accéder à d'autres dossiers.

    • Fichier de sortie non généré : vérifiez que votre code écrit dans le nom de fichier de sortie attendu et qu'aucune erreur n'empêche la création ou l'écriture du fichier.

    • Limites de taille : la taille des fichiers est limitée à 100 Mo.

  • Persistance de l'état : si votre code repose sur un état précédent, vérifiez que vous utilisez le même sandbox_name pour les appels suivants. Assurez-vous également que le bac à sable n'a pas expiré.

  • Délai avant expiration : l'exécution du code expire après 300 secondes. Envisagez d'optimiser votre code pour améliorer les performances ou de décomposer les tâches complexes en étapes plus petites et plus faciles à gérer.

Gestion et nettoyage du bac à sable

  • Bac à sable introuvable pour suppression : si vous ne parvenez pas à supprimer un bac à sable, assurez-vous que le sandbox_name que vous utilisez est correct et que le bac à sable existe toujours.

  • Moteur d'agent introuvable pour suppression : comme pour les bacs à sable, vérifiez le agent_engine_name lorsque vous tentez de supprimer le moteur d'agent.

  • Quotas de ressources : si vous créez de nombreux bacs à sable ou effectuez des exécutions fréquentes, vous pouvez rencontrer des limites de quotas de ressources. Vérifiez les quotas de votre projet pour les services Vertex AI et demandez des augmentations si nécessaire. Pour obtenir la liste des quotas Agent Engine, consultez Quotas.