샌드박스 관리

이 페이지에서는 Python SDK를 사용하여 활성 샌드박스 환경의 수명 주기를 관리하는 방법을 보여줍니다. 기존 샌드박스를 나열하고 세부정보를 보거나 더 이상 필요하지 않은 경우 삭제할 수 있습니다.

시작하기 전에

샌드박스를 관리하려면 프로젝트에 다음 역할이 필요합니다.

  • Agent Platform 사용자 (roles/aiplatform.user)

샌드박스 관리

Agent Platform 인스턴스와 연결된 활성 샌드박스 환경을 나열하고 세부정보를 보고 삭제할 수 있습니다. 기존 샌드박스의 구성을 변경하려면 삭제하고 새 샌드박스를 만들어야 합니다.

샌드박스 나열

Agent Platform 인스턴스와 연결된 모든 샌드박스를 나열하려면 다음 안내를 따르세요.

import vertexai

client = vertexai.Client(project='<var>PROJECT_ID</var>', location='<var>LOCATION</var>')
instance_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID'

sandboxes = client.agent_engines.sandboxes.list(name=instance_name)

for sandbox in sandboxes:
    print(sandbox.name)

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID입니다. Google Cloud
  • LOCATION: Agent Platform 인스턴스의 Google Cloud 리전입니다. 지원되는 리전을 참조하세요.
  • INSTANCE_ID: Agent Platform 인스턴스 ID입니다.

샌드박스 세부정보 보기

특정 샌드박스의 구성 및 상태를 보려면 다음 안내를 따르세요.

sandbox_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID/sandboxEnvironments/SANDBOX_ID'

sandbox = client.agent_engines.sandboxes.get(name=sandbox_name)
print(sandbox)

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID입니다. Google Cloud
  • LOCATION: Agent Platform 인스턴스의 Google Cloud 리전입니다. 지원되는 리전을 참조하세요.
  • INSTANCE_ID: 샌드박스가 포함된 Agent Platform 인스턴스 ID입니다.
  • SANDBOX_ID: 기존 샌드박스 ID입니다.

출력에는 생성 시간, 상태 (예: STATE_RUNNING), 샌드박스 사양과 같은 세부정보가 포함됩니다.

샌드박스 삭제

샌드박스 환경을 명시적으로 삭제하고 리소스를 확보하려면 다음 안내를 따르세요.

client.agent_engines.sandboxes.delete(name=sandbox_name)
print("Sandbox deleted.")