排解 Agent Runtime 的環境設定問題

本文說明如何解決設定 Agent Runtime 環境時可能發生的錯誤。本文將說明如何排解套件匯入問題。

匯入 Agent Platform SDK 時發生錯誤

如果無法匯入 Agent Platform SDK for Python,可能是下列任一問題所致:

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