排解 Vertex AI Agent Engine 執行階段環境設定問題

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

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

如果無法匯入 Python 適用的 Vertex AI SDK,可能是下列問題所致:

過時的 Vertex AI SDK for Python 版本

問題

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

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