排解設定環境的問題

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

匯入 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)，可能需要重新啟動執行階段，才能使用更新的套件。