Vertex AI SDK for Python을 가져올 수 없는 경우 다음 문제 중 하나가 원인일 수 있습니다.
오래된 버전의 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 패키지 버전을 확인하려면 터미널에서 다음 명령어를 실행합니다.
pipshowgoogle-cloud-aiplatform
추천 솔루션:
터미널에서 다음 명령어를 실행하여 google-cloud-aiplatform 패키지를 업데이트합니다.
pipinstallgoogle-cloud-aiplatform--upgrade
다음 명령어를 실행하여 업데이트된 버전이 1.82.0 이상인지 확인합니다.
pipshowgoogle-cloud-aiplatform
노트북 인스턴스(예: Jupyter, Colab 또는 Workbench)를 사용하는 경우 업데이트된 패키지를 사용하려면 런타임을 다시 시작해야 할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Troubleshoot setting up an environment\n\nThis document describes how to resolve errors that you might encounter when\n[setting up an environment](/vertex-ai/generative-ai/docs/agent-engine/set-up).\n\nErrors when importing the Vertex AI SDK for Python\n--------------------------------------------------\n\nIf you can't import the Vertex AI SDK for Python, it might be caused by one of the\nfollowing issues:\n\n### Outdated version of the Vertex AI SDK for Python\n\n**Issue**:\n\nYou receive an error message similar to the following: \n\n ImportError: cannot import name 'reasoning_engines' from 'vertexai.preview'\n\nor \n\n ImportError: cannot import name 'agent_angines' from 'vertexai'\n\n**Possible cause**:\n\nThis might happen if the version of your `google-cloud-aiplatform` package\nis earlier than `1.82.0` (for `agent_engines`) or `1.47.0`\n(for `reasoning_engines`). To check the version of your `google-cloud-aiplatform`\npackage, run the following command in the terminal: \n\n pip show google-cloud-aiplatform\n\n**Recommended solution**:\n\nRun the following command in your terminal to update your\n`google-cloud-aiplatform` package: \n\n pip install google-cloud-aiplatform --upgrade\n\nVerify your updated version is `1.82.0` or later by running the following command: \n\n pip show google-cloud-aiplatform\n\nIf you're in a notebook instance (For example, Jupyter or Colab or Workbench),\nyou might need to restart your runtime to use the updated packages."]]
