Résoudre les problèmes de configuration de l'environnement pour Agent Runtime

Ce document explique comment résoudre les erreurs que vous pouvez rencontrer lors de la configuration d'un environnement pour Agent Runtime. Il décrit les étapes de dépannage pour les problèmes d'importation de packages.

Erreurs lors de l'importation du SDK Agent Platform

Si vous ne parvenez pas à importer le SDK Agent Platform pour Python, cela peut être dû à l'un des problèmes suivants :

Version obsolète du SDK Agent Platform pour Python

Problème :

Vous recevez un message d'erreur semblable à celui-ci :

ImportError: cannot import name 'reasoning_engines' from 'vertexai.preview'

ou

ImportError: cannot import name 'agent_angines' from 'vertexai'

Cause possible :

Cela peut se produire si la version de votre package google-cloud-aiplatform est antérieure à 1.82.0 (pour agent_engines) ou 1.47.0 (pour reasoning_engines). Pour vérifier la version de votre package google-cloud-aiplatform, exécutez la commande suivante dans le terminal :

pip show google-cloud-aiplatform

Solution recommandée :

Exécutez la commande suivante dans votre terminal pour mettre à jour votre package google-cloud-aiplatform :

pip install google-cloud-aiplatform --upgrade

Vérifiez que votre version mise à jour est 1.82.0 ou ultérieure en exécutant la commande suivante :

pip show google-cloud-aiplatform

Si vous vous trouvez dans une instance de notebook (par exemple, Jupyter, Colab ou Workbench), vous devrez peut-être redémarrer votre environnement d'exécution pour utiliser les packages mis à jour.