Memecahkan masalah penyiapan lingkungan untuk Vertex AI Agent Engine Runtime

Dokumen ini menjelaskan cara mengatasi error yang mungkin Anda alami saat menyiapkan lingkungan.

Error saat mengimpor Vertex AI SDK for Python

Jika Anda tidak dapat mengimpor Vertex AI SDK untuk Python, hal ini mungkin disebabkan oleh salah satu masalah berikut:

Versi Vertex AI SDK for Python yang sudah usang

Masalah:

Anda akan menerima pesan error yang mirip dengan berikut ini:

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

atau

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

Kemungkinan penyebab:

Hal ini dapat terjadi jika versi paket google-cloud-aiplatform Anda lebih lama dari 1.82.0 (untuk agent_engines) atau 1.47.0 (untuk reasoning_engines). Untuk memeriksa versi paket google-cloud-aiplatform Anda, jalankan perintah berikut di terminal:

pip show google-cloud-aiplatform

Solusi yang direkomendasikan:

Jalankan perintah berikut di terminal untuk mengupdate paket google-cloud-aiplatform:

pip install google-cloud-aiplatform --upgrade

Verifikasi bahwa versi yang diupdate adalah 1.82.0 atau yang lebih baru dengan menjalankan perintah berikut:

pip show google-cloud-aiplatform

Jika Anda berada di instance notebook (Misalnya, Jupyter atau Colab atau Workbench), Anda mungkin perlu memulai ulang runtime untuk menggunakan paket yang diupdate.