A partire dal 29 aprile 2025, i modelli Gemini 1.5 Pro e Gemini 1.5 Flash non sono disponibili nei progetti che non li hanno mai utilizzati, inclusi i nuovi progetti. Per maggiori dettagli, vedi Versioni e ciclo di vita dei modelli.
Risolvere i problemi di configurazione di un ambiente
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo documento descrive come risolvere gli errori che potresti riscontrare durante la configurazione di un ambiente.
Errori durante l'importazione dell'SDK Vertex AI per Python
Se non riesci a importare l'SDK Vertex AI per Python, il motivo potrebbe essere 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:
Questo può 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 il seguente comando nel terminale:
pipshowgoogle-cloud-aiplatform
Soluzione consigliata:
Esegui questo comando nel terminale per aggiornare il pacchetto google-cloud-aiplatform:
pipinstallgoogle-cloud-aiplatform--upgrade
Verifica che la versione aggiornata sia 1.82.0 o successiva eseguendo il seguente comando:
pipshowgoogle-cloud-aiplatform
Se sei in un'istanza del notebook (ad esempio Jupyter, Colab o Workbench),
potrebbe essere necessario riavviare il runtime per utilizzare i pacchetti aggiornati.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[],[],null,["# Troubleshoot setting up an environment\n\nThis document describes how to resolve errors that you might encounter when\n[setting up an environment](/vertex-ai/generative-ai/docs/agent-engine/set-up).\n\nErrors when importing the Vertex AI SDK for Python\n--------------------------------------------------\n\nIf you can't import the Vertex AI SDK for Python, it might be caused by one of the\nfollowing issues:\n\n### Outdated version of the Vertex AI SDK for Python\n\n**Issue**:\n\nYou receive an error message similar to the following: \n\n ImportError: cannot import name 'reasoning_engines' from 'vertexai.preview'\n\nor \n\n ImportError: cannot import name 'agent_angines' from 'vertexai'\n\n**Possible cause**:\n\nThis might happen if the version of your `google-cloud-aiplatform` package\nis earlier than `1.82.0` (for `agent_engines`) or `1.47.0`\n(for `reasoning_engines`). To check the version of your `google-cloud-aiplatform`\npackage, run the following command in the terminal: \n\n pip show google-cloud-aiplatform\n\n**Recommended solution**:\n\nRun the following command in your terminal to update your\n`google-cloud-aiplatform` package: \n\n pip install google-cloud-aiplatform --upgrade\n\nVerify your updated version is `1.82.0` or later by running the following command: \n\n pip show google-cloud-aiplatform\n\nIf you're in a notebook instance (For example, Jupyter or Colab or Workbench),\nyou might need to restart your runtime to use the updated packages."]]