Neste documento, descrevemos como resolver erros que podem ser encontrados ao configurar um ambiente para o ambiente de execução de agentes. Ele aborda etapas de solução de problemas para problemas de importação de pacotes.
Erros ao importar o SDK da plataforma de agentes
Quando não é possível importar o SDK da plataforma de agentes para Python, a causa pode ser um dos seguintes problemas:
Versão desatualizada do SDK da plataforma de agentes 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:
pip show google-cloud-aiplatformSolução recomendada:
Execute o seguinte comando no terminal para atualizar o
pacote google-cloud-aiplatform:
pip install google-cloud-aiplatform --upgradeVerifique se a versão atualizada é 1.82.0 ou mais recente executando o seguinte comando:
pip show google-cloud-aiplatformNo 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.