A partir de 29 de abril de 2025, os modelos Gemini 1.5 Pro e Gemini 1.5 Flash não estarão disponíveis em projetos que não os usaram antes, incluindo novos projetos. Para mais detalhes, consulte Versões e ciclo de vida do modelo.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste documento, descrevemos como resolver erros que podem ser encontrados ao
configurar um ambiente.
Erros ao importar o SDK da Vertex AI para Python
Quando não é possível importar o SDK da Vertex AI para Python, a causa pode ser um dos
seguintes problemas:
Versão desatualizada do SDK da Vertex AI para Python
Problema:
Você recebe uma mensagem de erro semelhante a esta:
ImportError: cannot import name 'reasoning_engines' from 'vertexai.preview'
ou
ImportError: cannot import name 'agent_angines' from 'vertexai'
Possível causa:
Isso pode acontecer quando a versão do pacote google-cloud-aiplatform
é anterior a 1.82.0 (para agent_engines) ou 1.47.0
(para reasoning_engines). Para verificar a versão do pacote google-cloud-aiplatform, execute o seguinte comando no terminal:
pipshowgoogle-cloud-aiplatform
Solução recomendada:
Execute o seguinte comando no terminal para atualizar o
pacote google-cloud-aiplatform:
pipinstallgoogle-cloud-aiplatform--upgrade
Verifique se a versão atualizada é 1.82.0 ou mais recente executando o seguinte comando:
pipshowgoogle-cloud-aiplatform
No caso de uma instância de notebook (por exemplo, Jupyter, Colab ou Workbench),
talvez seja necessário reiniciar o ambiente de execução para usar os pacotes atualizados.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 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."]]
