排解設定環境的問題

本文說明如何解決設定環境時可能遇到的錯誤。

匯入 Vertex AI SDK for Python 時發生錯誤

如果無法匯入 Vertex AI SDK for Python,可能是因為下列其中一個問題:

過時的 Python 適用 Vertex AI SDK 版本

問題

您會收到類似以下的錯誤訊息:

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

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

可能的原因

如果 google-cloud-aiplatform 套件的版本比 1.82.0 還舊 (適用於 agent_engines) 或 1.47.0 (適用於 reasoning_engines),就可能發生這種情況。如要檢查 google-cloud-aiplatform 套件的版本,請在終端機中執行下列指令:

pip show google-cloud-aiplatform

建議的解決方案

在終端機中執行下列指令,更新 google-cloud-aiplatform 套件:

pip install google-cloud-aiplatform --upgrade

執行下列指令,確認更新後的版本為 1.82.0 以上:

pip show google-cloud-aiplatform

如果您使用的是筆記本執行個體 (例如 Jupyter、Colab 或 Workbench),可能需要重新啟動執行階段,才能使用更新的套件。