Résoudre les problèmes de création d'un agent à l'aide d'Agent Runtime

Ce document explique comment résoudre les erreurs que vous pouvez rencontrer lors de la création d'un agent.

Erreurs de génération de contenu

Problème :

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

ValueError: Cannot get the Candidate text.
Response candidate content part has no text.

Cause possible :

Cette erreur peut être due à l'utilisation d'une version de langchain-google-vertexai non compatible avec google-cloud-aiplatform. La version 1.0.2 ou ultérieure de langchain-google-vertexai est requise. Pour vérifier quelle version vous utilisez, exécutez la commande suivante dans votre terminal :

pip show langchain-google-vertexai

Solution recommandée :

Installez la version 1.0.2 de langchain-google-vertexai. Cette version inclut les mises à jour d'appel d'outils LangChain requises pour fonctionner avec google-cloud-aiplatform. Pour mettre à jour votre version de langchain-google-vertexai, exécutez la commande suivante dans votre terminal :

pip install langchain-google-vertexai --upgrade

Après avoir exécuté la commande de mise à jour, vérifiez que vous utilisez la version 1.0.2 ou une version ultérieure en exécutant la commande suivante dans votre terminal :

pip show langchain-google-vertexai

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.

Erreur de création initiale de votre propre conteneur (BYOC)

Problème :

Vous déployez des agents via BYOC dans votre Google Cloud projet pour la première fois dans la région où vous vous trouvez, et vous recevez un message d'erreur semblable à celui-ci :

Reasoning Engine resource <reasoning-engine-id> failed to start and cannot serve traffic.

Cause possible :

L'échec est probablement dû au provisionnement IAM interne d'Agent Runtime sur Gemini Enterprise Agent Platform. La finalisation et la propagation des modifications prennent du temps.

Solution recommandée :

Réessayez la même requête de déploiement d'agent. Elle devrait aboutir.