서빙 구성 관리

이 페이지에서는 서빙 구성을 삭제, 수정, 나열하고 각 구성의 통계를 검토하는 방법을 설명합니다.

새 서빙 구성을 만드는 방법은 서빙 구성 만들기를 참조하세요.

기존 게재위치가 있거나 새 게재위치를 만들면 Vertex AI Search for Retail이 각 게재위치와 연관된 서빙 구성을 자동으로 만듭니다. 서빙 구성을 만들어도 해당 게재위치가 생성되지 않습니다. 서빙 구성을 삭제하면 해당 게재위치가 삭제되고 해당 배치가 삭제됩니다.

서빙 구성 수정

Search for Retail 콘솔 또는 API를 사용하여 서빙 구성을 수정할 수 있습니다.

콘솔에서 서빙 구성 수정

서빙 구성 페이지에서 각 서빙 구성의 컨트롤을 보고 수정할 수 있습니다. 서빙 구성을 클릭하여 해당 설정의 모든 제공 및 사이트 전체 컨트롤을 나열하는 세부정보 페이지를 확인합니다.

이 페이지에서 컨트롤을 수정하거나 새 컨트롤을 만들거나 기존 컨트롤을 구성에 적용할 수 있습니다.

새로 생성되거나 업데이트된 서빙 구성이 실시간 트래픽을 처리할 준비가 되려면 몇 분 정도 걸립니다. 평가 페이지에서 변경사항을 즉시 테스트할 수 있습니다.

서빙 구성 인라인 수정

API 메서드를 사용하여 서빙 구성 필드를 업데이트하고, 서빙 컨트롤을 추가하고, 서빙 컨트롤을 인라인으로 삭제할 수 있습니다.

서빙 구성 인라인 패치

서빙 구성의 필드를 업데이트하려면 ServingConfig.patch를 사용하고 요청 본문에 ServingConfig 인스턴스를 포함합니다. updateMask 매개변수로 업데이트하도록 필드를 지정하거나 지원되는 모든 필드를 업데이트하도록 필드를 설정하지 않습니다.

이 메서드에 대한 자세한 내용은 ServingConfig.patch 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/servingConfigs/SERVING_CONFIG_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

서빙 구성에 인라인으로 컨트롤 추가

서빙 구성에 컨트롤을 추가하려면 ServingConfig.addControl을 사용합니다. 컨트롤은 속해 있는 컨트롤 목록의 마지막 위치에 추가됩니다. 예를 들어 facetSpec 컨트롤은 servingConfig.facetSpecIds의 마지막 위치에 적용됩니다.

이 메서드에 대한 자세한 내용은 ServingConfig.addControl API 참조를 확인하세요.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

서빙 구성에서 인라인 컨트롤 삭제

서빙 구성에서 컨트롤을 삭제하려면 ServingConfig.removeControl을 사용합니다.

이 메서드에 대한 자세한 내용은 ServingConfig.removeControl API 참조를 확인하세요.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:removeControl'

서빙 구성 보기

Search for Retail 콘솔 또는 API를 사용하여 서빙 구성을 볼 수 있습니다.

콘솔에서 서빙 구성 보기

서빙 구성 페이지에서 모든 서빙 구성을 확인할 수 있습니다.

서빙 구성 인라인 보기

단일 서빙 구성 인라인으로 보려면 ServingConfig.get을 사용합니다.

이 메서드에 대한 자세한 내용은 ServingConfig.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/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

모든 서빙 구성 인라인을 나열하려면 ServingConfig.list를 사용합니다.

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

이 메서드에 대한 자세한 내용은 ServingConfig.list 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/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

서빙 구성 삭제

Search for Retail 콘솔 또는 API를 사용하여 서빙 구성을 삭제할 수 있습니다.

콘솔에서 서빙 구성 삭제

콘솔에서 서빙 구성을 삭제하려면 다음 안내를 따르세요.

  1. Search for Retail 콘솔에서 서빙 구성 페이지로 이동합니다.

    서빙 구성 페이지로 이동

  2. 삭제할 서빙 구성을 클릭하여 세부정보 페이지를 엽니다.

  3. 페이지 상단의 버튼 모음에서 삭제를 클릭합니다.

  4. 서빙 구성이 활성으로 간주되는 경우 ID를 다시 입력하고 확인을 클릭하여 삭제를 완료해야 합니다.

서빙 구성 인라인 삭제

단일 서빙 구성을 인라인으로 삭제하려면 ServingConfig.delete를 사용합니다.

이 메서드에 대한 자세한 내용은 ServingConfig.delete 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/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

서빙 구성 통계 검토

서빙 구성 페이지에서 각 서빙 구성에 대한 세부정보를 볼 수 있습니다. 표에 나와 있는 모든 구성에서 분석 보기를 클릭하여 통계를 확인합니다.

클릭률은 서빙 구성의 검색당 클릭수를 보여줍니다. 전환율은 구성의 검색당 구매수를 나타냅니다.