Fehlerbehebung bei der Einrichtung der Umgebung für die Laufzeit für KI-Agenten

In diesem Dokument wird beschrieben, wie Sie Fehler beheben können, die beim Einrichten einer Umgebung für die Agent Runtime auftreten können. Darin werden Schritte zur Fehlerbehebung bei Problemen mit dem Paketimport beschrieben.

Fehler beim Importieren des Agent Platform-SDK

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

Veraltete Version des Agent Platform 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.