Resolva problemas de configuração de um ambiente para o tempo de execução do Vertex AI Agent Engine

Este documento descreve como resolver erros que pode encontrar ao configurar um ambiente.

Erros ao importar o SDK Vertex AI para Python

Se não conseguir importar o SDK Vertex AI para Python, tal pode dever-se a um dos seguintes problemas:

Versão desatualizada do SDK Vertex AI for Python

Problema:

Recebe uma mensagem de erro semelhante à seguinte:

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

ou

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

Causa possível:

Isto pode acontecer se a versão do pacote google-cloud-aiplatform for 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:

pip show google-cloud-aiplatform

Solução recomendada:

Execute o seguinte comando no terminal para atualizar o pacote google-cloud-aiplatform:

pip install google-cloud-aiplatform --upgrade

Verifique se a versão atualizada é a 1.82.0 ou posterior executando o seguinte comando:

pip show google-cloud-aiplatform

Se estiver numa instância de bloco de notas (por exemplo, Jupyter, Colab ou Workbench), pode ter de reiniciar o tempo de execução para usar os pacotes atualizados.