모델 관리

이 페이지에서는 추천 모델을 미세 조정, 일시중지, 재개, 삭제, 나열하는 방법을 설명합니다. 새 추천 모델을 만드는 방법에 대한 도움말은 추천 모델 만들기를 참조하세요.

모델 조정

소매업용 Vertex AI Search는 모델에 제공되는 입력 데이터를 사용하여 학습용 초매개변수를 조정합니다.

조정에는 2~4일이 걸리며 모델이 그대로 계속 작동합니다. 비용 미세 조정에 대한 자세한 내용은 가격 책정을 참조하세요.

모델의 미세 조정 주파수 설정

주기적으로 모델을 미세 조정하는 것이 좋습니다. 이렇게 하면 일 년 동안 데이터가 변경되고 고객 행동이 달라짐에 따라 모델 학습이 최적의 상태로 유지됩니다. 또한 모델이 미세 조정된 후에만 적용할 수 있는 내부 주요 모델 업그레이드도 있습니다.

모델을 만들 때 3개월마다 자동으로 미세 조정되도록 설정하거나 수동으로만 미세 조정되도록 선택할 수 있습니다. 선택한 설정과 관계없이 모델은 생성 후에 자동으로 1회 미세 조정됩니다.

언제든지 미세 조정 상태 설정을 변경할 수 있습니다. 이 설정을 변경해도 현재 실행 중인 미세 조정 프로세스에는 영향을 미치지 않습니다.

모델의 미세 조정 상태 설정을 수정하려면 다음 안내를 따르세요.

콘솔

  1. Search for Retail 콘솔의 모델 페이지로 이동합니다.

    모델 페이지로 이동

    미세 조정 상태에서 모든 모델의 미세 조정 상태를 확인할 수 있습니다.

  2. 모델 이름을 클릭하여 세부정보 페이지를 봅니다.

  3. 미세 조정 상태 옆에 있는 수정 을 클릭합니다.

  4. 드롭다운 목록에서 설정을 선택합니다.

    • 3개월마다. 90일 전에 마지막 미세 조정이 이루어진 경우 자동으로 조정됩니다.
    • 수동 미세 조정만. 수동으로 미세 조정할 때만 미세 조정합니다.

  5. 완료()를 클릭하여 설정을 저장합니다.

curl

API를 사용하여 Models.patch 요청을 수행합니다. Models.patch API 참조를 확인하세요.

모든 Models 필드에 대한 자세한 내용은 Models API 참조를 확인하세요.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID",
  "PeriodicTuningState": "NEW_TUNING_STATE_VALUE"
}' \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID?updateMask=PeriodicTuningState'

수동으로 모델 미세 조정

수동 미세 조정은 모델을 한 번만 미세 조정합니다. 카탈로그에 상당한 변경(예: 크기 증가 또는 카탈로그 계층 구조 변화) 또는 이벤트(예: 이전 이벤트 백필 또는 특정 항목 그룹 승격 후 데이터 분포 변화)가 발생하면 모델을 수동으로 미세 조정할 수 있습니다.

모델을 수동으로 미세 조정하려면 다음 안내를 따르세요.

콘솔

  1. Search for Retail 콘솔의 모델 페이지로 이동합니다.

    모델 페이지로 이동

  2. 모델 이름을 클릭하여 세부정보 페이지를 봅니다.

  3. 버튼 모음에서 수동 미세 조정을 클릭합니다.

    미세 조정에는 2~4일이 걸리며 모델이 그대로 계속 작동합니다.

curl

API를 사용하여 Models.tune 요청을 수행합니다. Models.tune API 참조를 확인하세요.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:tune'

모델 학습 일시중지 및 재개

모델이 활성(일시중지되지 않은) 상태이면 모델이 주 1회 이상, 하루 1회 미만으로 재학습됩니다. 일관된 재학습을 위해서는 이벤트가 발생한 후 24시간 이내에 사용자 이벤트 데이터를 업로드해야 합니다.

재학습을 중지하려면 모델을 일시중지하면 됩니다. 잘못된 데이터를 가져왔거나 프로젝트당 활성 모델 한도인 10개를 초과하지 않기 위해 모델을 일시중지할 수 있습니다. 활성 모델이 10개 미만이라면 언제든지 일시중지된 모델을 다시 시작할 수 있습니다.

학습 비용에 대한 자세한 내용은 가격 책정을 참조하세요.

분당 최대 5개의 모델 작업을 시작할 수 있습니다. 한도가 적용되는 모델 작업에는 생성, 삭제, 일시중지, 다시 시작 등이 있습니다.

모델을 일시중지하거나 다시 시작하려면 다음 안내를 따르세요.

콘솔

  1. Search for Retail 콘솔의 모델 페이지로 이동합니다.

    모델 페이지로 이동

    학습 상태에서 모든 모델의 학습 상태를 확인할 수 있습니다.

  2. 활성 모델(학습 상태: 학습)을 일시중지하려면 일시중지()를 클릭합니다.

  3. 일시중지된 모델(학습 상태: 일시중지됨)을 시작하려면 재개( )를 클릭합니다.

curl

활성 모델을 일시중지하려면 API를 사용하여 Models.pause 요청을 수행합니다. Models.pause API 참조를 확인하세요.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:pause'

일시중지된 모델을 시작하려면 API를 사용하여 Models.resume 요청을 수행합니다.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:resume'

모델 세부정보 보기

Models.get API 메서드를 사용하거나 콘솔에서 모델의 세부정보를 봅니다.

특정 모델과 관련된 제공 구성을 보려면 아래 콘솔 절차를 사용합니다. 다른 모든 모델의 세부정보는 콘솔과 API 응답 모두에서 확인할 수 있습니다.

콘솔

  1. Search for Retail 콘솔의 모델 페이지로 이동합니다.

    모델 페이지로 이동

  2. 모델 페이지에 모든 모델과 학습 및 쿼리 상태가 나열됩니다.

  3. 모델 이름을 클릭하여 세부정보 페이지를 봅니다.

curl

단일 모델의 정보를 가져오려면 API를 사용하여 Models.get 요청을 전송합니다. Models.get API 참조를 확인하세요.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'

모델 나열

콘솔에서 또는 Models.list API 메서드를 사용하여 모델 목록을 봅니다.

콘솔

  1. Search for Retail 콘솔의 모델 페이지로 이동합니다.

    모델 페이지로 이동

  2. 모델 페이지에 모든 모델과 학습 및 쿼리 상태가 나열됩니다.

curl

모든 모델 및 세부정보를 인라인으로 나열하려면 API를 사용하여 Models.list 요청을 수행합니다. Models.list API 참조를 확인하세요.

필요한 경우 pageSize 매개변수를 사용하여 반환할 최대 결과 수를 설정할 수 있습니다. 더 많은 결과를 사용할 수 있는 경우 list 응답에 페이지 토큰이 포함됩니다. list 요청의 pageToken 매개변수에 페이지 토큰을 전달하여 결과의 다음 페이지를 검색할 수 있습니다. 아래 예시에서는 두 매개변수를 모두 사용합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

모델 삭제

분당 최대 5개의 모델 작업을 시작할 수 있습니다. 한도가 적용되는 모델 작업에는 생성, 삭제, 일시중지, 다시 시작 등이 있습니다.

콘솔에서 또는 Models.delete API 메서드를 사용하여 모델을 삭제합니다.

콘솔

  1. Search for Retail 콘솔의 모델 페이지로 이동합니다.

    모델 페이지로 이동

  2. 삭제할 모델의 이름을 클릭하여 세부정보 페이지를 엽니다.

  3. 버튼 모음에서 삭제를 클릭합니다.

  4. 모델 이름을 다시 입력하고 확인을 클릭합니다.

curl

API를 사용하여 Models.delete 요청을 수행합니다. Models.delete API 참조를 확인하세요.

모든 Models 필드에 대한 자세한 내용은 Models API 참조를 확인하세요.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'