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

Cette section présente les problèmes courants et leurs solutions lorsque vous utilisez 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 Google Cloud projet dispose du rôle de Identity and Access Management (IAM) Utilisateur Vertex AI (roles/aiplatform.user).

  • ID de projet ou emplacement non valide : 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.

  • Agent Engine non créé : avant de créer un bac à sable, vérifiez que l'instance Agent Engine 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 erreurs 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 vos 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 : le délai avant expiration de l'exécution du code est de 300 secondes. Envisagez d'optimiser votre code pour améliorer les performances ou de diviser les tâches complexes en étapes plus petites et plus faciles à gérer.

Gestion et nettoyage des bacs à sable

  • Bac à sable introuvable pour la 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.

  • Agent Engine introuvable pour la suppression : comme pour les bacs à sable, vérifiez le agent_engine_name lorsque vous tentez de supprimer Agent Engine.

  • Quotas de ressources : si vous créez de nombreux bacs à sable ou effectuez des exécutions fréquentes, vous pouvez atteindre les limites de quota 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 d'Agent Engine, consultez Quotas.