환경 설정

Google Cloud 프로젝트 설정

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Vertex AI and Cloud Storage APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Vertex AI and Cloud Storage APIs.

   Enable the APIs

필요한 역할 얻기

Reasoning Engine을 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

• Vertex AI 사용자(roles/aiplatform.user)
• 스토리지 관리자(roles/storage.admin)
• Vertex AI Reasoning Engine 서비스 에이전트(roles/aiplatform.reasoningEngineServiceAgent)

역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

Cloud Storage 버킷 만들기

Reasoning Engine은 배포 프로세스 중에 Cloud Storage 버킷에서 애플리케이션의 아티팩트를 스테이징합니다. Python용 Vertex AI SDK를 사용하도록 인증된 주 구성원(사용자 또는 서비스 계정)에게 이 버킷에 대한 Storage Admin 액세스 권한이 있는지 확인합니다. Python용 Vertex AI SDK는 자동으로 코드를 패키징하고 이후 단계에서 이 버킷에 쓰기 때문에 필요합니다.

Google Cloud 콘솔

1. In the Google Cloud console, go to the Cloud Storage Buckets page.

   Go to Buckets page

2. Click Create bucket.
3. On the Create a bucket page, enter your bucket information. To go to the next step, click Continue.
   • For Name your bucket, enter a name that meets the bucket naming requirements.
   • For Choose where to store your data, do the following:
     • Select a Location type option.
     • Select a Location option.
   • For Choose a default storage class for your data, select a storage class.
   • For Choose how to control access to objects, select an Access control option.
   • For Advanced settings (optional), specify an encryption method, a retention policy, or bucket labels.
4. Click Create.

명령줄

Create a Cloud Storage bucket and configure it as follows:
• STORAGE_CLASS를 원하는 스토리지 클래스로 바꿉니다.
• LOCATION을 원하는 위치(ASIA, EU, US)로 바꿉니다.
• BUCKET_NAME을 버킷 이름 요구사항을 충족하는 버킷 이름으로 바꿉니다.

gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

Python용 Vertex AI SDK 설치 및 초기화

다음 명령어를 실행하여 Reasoning Engine에 Python용 Vertex AI SDK를 설치합니다.

pip install google-cloud-aiplatform[reasoningengine,langchain]

다음 코드를 실행하여 Reasoning Engine용 SDK를 가져오고 초기화합니다.

import vertexai
from vertexai.preview import reasoning_engines

vertexai.init(
    project="PROJECT_ID",
    location="gs://BUCKET_NAME",
    staging_bucket="LOCATION",
)

• PROJECT_ID: 프로젝트 ID입니다.
• BUCKET_NAME: Google Cloud 버킷입니다.
• LOCATION: 리전 현재는 us-central1만 지원됩니다.

다음 단계

• 애플리케이션 개발