Risolvere i problemi di configurazione dell'ambiente per Agent Runtime

Questo documento descrive come risolvere gli errori che potresti riscontrare durante la configurazione di un ambiente per Agent Runtime. Vengono illustrati i passaggi per la risoluzione dei problemi di importazione dei pacchetti.

Errori durante l'importazione dell'SDK Agent Platform

Se non riesci a importare l'SDK Agent Platform Python, il problema potrebbe essere dovuto a uno dei seguenti motivi:

Versione obsoleta dell'SDK Agent Platform 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:

Questo problema può verificarsi 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 successiva 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.