Fehlerbehebung beim Einrichten einer Umgebung für die Vertex AI Agent Engine-Laufzeit

In diesem Dokument wird beschrieben, wie Sie Fehler beheben können, die beim Einrichten einer Umgebung auftreten können.

Fehler beim Importieren des Vertex AI SDK für Python

Wenn Sie das Vertex AI SDK für Python nicht importieren können, kann das folgende Ursachen haben:

Veraltete Version des Vertex AI SDK für Python

Problem:

Möglicherweise erhalten Sie eine Fehlermeldung, die so aussieht:

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

oder

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

Mögliche Ursache:

Dies kann auftreten, wenn die Version Ihres google-cloud-aiplatform-Pakets älter als 1.82.0 (für agent_engines) oder 1.47.0 (für reasoning_engines) ist. Führen Sie den folgenden Befehl im Terminal aus, um die Version Ihres google-cloud-aiplatform-Pakets zu prüfen:

pip show google-cloud-aiplatform

Empfohlene Lösung:

Führen Sie im Terminal den folgenden Befehl aus, um das google-cloud-aiplatform-Paket zu aktualisieren:

pip install google-cloud-aiplatform --upgrade

Prüfen Sie mit dem folgenden Befehl, ob Ihre aktualisierte Version 1.82.0 oder höher ist:

pip show google-cloud-aiplatform

Wenn Sie sich in einer Notebookinstanz befinden (z. B. Jupyter, Colab oder Workbench), müssen Sie möglicherweise Ihre Laufzeit neu starten, um die aktualisierten Pakete verwenden zu können.