Risolvi i problemi di configurazione di un ambiente per il runtime di Vertex AI Agent Engine

Questo documento descrive come risolvere gli errori che potresti riscontrare durante l'impostazione di un ambiente.

Errori durante l'importazione dell'SDK Vertex AI Python

Se non riesci a importare l'SDK Vertex AI Python, il problema potrebbe essere dovuto a uno dei seguenti problemi:

Versione obsoleta dell'SDK Vertex AI per Python

Problema:

Ricevi un messaggio di errore simile al seguente:

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

o

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

Possibile causa:

Ciò potrebbe accadere se la versione del pacchetto google-cloud-aiplatform è precedente a 1.82.0 (per agent_engines) o 1.47.0 (per reasoning_engines). Per controllare la versione del pacchetto google-cloud-aiplatform, esegui questo comando nel terminale:

pip show google-cloud-aiplatform

Soluzione consigliata:

Esegui questo comando nel terminale per aggiornare il pacchetto google-cloud-aiplatform:

pip install google-cloud-aiplatform --upgrade

Verifica che la versione aggiornata sia 1.82.0 o successive eseguendo questo comando:

pip show google-cloud-aiplatform

Se ti trovi in un'istanza notebook (ad esempio Jupyter, Colab o Workbench), potresti dover riavviare il runtime per utilizzare i pacchetti aggiornati.