서빙 컨트롤 관리

이 페이지에서는 서빙 컨트롤을 보고, 수정하고, 삭제하고, 내보내고, 가져오는 방법을 설명합니다.

서빙 컨트롤에 대한 일반적인 정보와 서빙 컨트롤을 만드는 방법에 대한 안내는 서빙 컨트롤 정보 및 서빙 컨트롤 만들기를 참조하세요.

서빙 컨트롤 보기 및 수정

콘솔 및 API를 사용하여 Vertex AI Search for Retail에 대해 서빙 컨트롤을 볼 수 있습니다.

콘솔에서 서빙 컨트롤 보기 및 수정

컨트롤 페이지의 서빙 컨트롤 탭에 모든 서빙 컨트롤과 관련 서빙 구성이 나열됩니다. 컨트롤의 컨트롤 수정 아이콘을 클릭하여 컨트롤 수정 패널에서 설정 및 관련 서빙 구성을 변경합니다. 컨트롤의 컨트롤 삭제 아이콘을 클릭하여 삭제합니다. 그러면 모든 서빙 구성에서도 삭제됩니다.

또한 서빙 구성 페이지에서 특정 서빙 구성의 컨트롤을 확인하고 수정할 수 있습니다. 서빙 구성을 클릭하여 해당 구성에 대한 모든 서빙 컨트롤을 나열하는 세부정보 페이지를 봅니다. 컨트롤 수정 패널에서 설정을 변경하려면 컨트롤의 컨트롤 수정 아이콘을 클릭합니다. 컨트롤 삭제 아이콘을 클릭하여 서빙 구성에서 컨트롤을 연결 해제합니다(컨트롤은 삭제되지 않음).

새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

서빙 컨트롤을 인라인으로 보기

단일 서빙 컨트롤을 인라인으로 보려면 Control.get을 사용합니다.

이 메서드에 대한 자세한 내용은 Control.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/controls/CONTROL_ID'

여러 서빙 컨트롤을 인라인으로 나열하려면 Controls.list를 사용합니다.

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

특정 서빙 구성과 관련된 컨트롤만 나열하려면 filter 쿼리 매개변수를 사용하여 서빙 구성 ID를 지정합니다.

이 메서드에 대한 자세한 내용은 Control.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/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

서빙 컨트롤을 인라인으로 패치

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

이 메서드에 대한 자세한 내용은 Controls.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/controls/CONTROL_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/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

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

서빙 구성에 컨트롤을 추가하려면 ServingConfig.addControl을 사용합니다.

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

이 메서드의 예시는 서빙 구성 관리를 참조하세요.

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

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

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

이 메서드의 예시는 서빙 구성 관리를 참조하세요.

서빙 컨트롤 삭제

Controls.delete 메서드를 사용하여 콘솔 또는 인라인에서 서빙 컨트롤을 삭제할 수 있습니다.

콘솔에서 서빙 컨트롤 삭제

서빙 컨트롤을 삭제하여 사용 중인 모든 서빙 구성에서 컨트롤을 삭제합니다.

1. Search for Retail 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

2. 삭제할 컨트롤의 테이블 행에서 삭제를 클릭합니다.

3. 확인 창에서 삭제를 클릭하여 삭제를 완료합니다.

서빙 컨트롤을 인라인으로 삭제

서빙 컨트롤을 인라인으로 삭제하려면 Controls.delete를 사용합니다.

이 메서드에 대한 자세한 내용은 Controls.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/controls/SERVING_CONTROL_ID'

서빙 컨트롤 내보내기

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

서빙 컨트롤을 Cloud Storage 버킷의 파일로 내보낼 수 있습니다.

서빙 컨트롤을 내보내고 가져오는 이유는 두 가지입니다.

• 한 프로젝트에서 다른 프로젝트로 서빙 컨트롤을 이동하려면 다음 안내를 따르세요.

• 전체 또는 일부 서빙 컨트롤에서 일괄 수정을 수행합니다. 서빙 컨트롤을 내보내고 내보낸 파일을 수정한 다음 파일을 가져와서 서빙 컨트롤을 변경하거나 추가합니다.

Search for Retail 콘솔을 통해 가져오기 및 내보내기를 수행할 수 있습니다. 서빙 컨트롤을 내보낼 때 프로젝트의 모든 서빙 컨트롤을 내보냅니다.

서빙 컨트롤을 내보내려면 다음 단계를 따르세요.

1. Search for Retail 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

2. 서빙 컨트롤 탭에서 내보내기 제어를 클릭합니다.

3. 서빙 컨트롤 내보내기 창에서 제어 파일을 내보낼 Cloud Storage 버킷을 선택합니다.

4. 내보내기를 클릭합니다.

   내보낸 컨트롤은 선택한 버킷의 NDJSON 파일에 다음 형식의 이름으로 저장됩니다.

   projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

5. 내보내기 작업이 완료된 후 내보내기 활동 창의 일괄 가져오기, 내보내기, 삭제 활동 목록에서 작업 상태를 확인할 수 있습니다. 메시지 창에서 표시를 클릭하거나 특정 통합 작업의 상태 보기의 안내에 따라 내보내기 활동 창을 엽니다.

서빙 컨트롤 가져오기

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

서빙 컨트롤을 추가하거나 기존 컨트롤을 일괄 수정하려면 내보낸 컨트롤 파일에서 변경할 수 있습니다. 그런 다음 원본 프로젝트 또는 다른 프로젝트로 가져올 수 있습니다.

서빙 컨트롤 가져오기에 대해 알아야 할 사항은 다음과 같습니다.

• Search 및 Recommendations 서빙 컨트롤이 모두 포함된 경우 서빙 컨트롤 파일을 가져올 수 없습니다.

• 서빙 컨트롤을 가져오면 파일의 모든 서빙 컨트롤이 가져올 때 지정한 서빙 구성과 연결됩니다. 서빙 컨트롤이 프로젝트의 다른 서빙 구성과 이미 연결되어 있는 경우 해당 연결도 유지됩니다.

서빙 컨트롤을 가져오려면 다음 단계를 따르세요.

1. 내보낸 서빙 컨트롤 파일을 수정 및 검토하고 파일을 Cloud Storage 버킷에 저장합니다. (서빙 컨트롤을 내보내려면 위의 태스크 서빙 컨트롤 내보내기를 참조하세요.)

   파일에 Search 서빙 컨트롤이나 Recommendations 서빙 컨트롤만 포함되어 있는지 확인합니다. 두 가지 유형이 모두 포함된 파일을 가져올 수 없습니다.

2. Search for Retail 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

3. 서빙 컨트롤 탭에서 컨트롤 가져오기를 클릭합니다.

4. 서빙 컨트롤 가져오기 창에서 다음을 수행합니다.

   1. 가져오려는 컨트롤이 포함된 Cloud Storage 버킷 및 NDJSON 파일을 찾아서 선택합니다.

   2. 가져온 서빙 컨트롤을 연결할 서빙 구성을 선택합니다.

   3. 가져오기 미리보기 계획을 검토합니다. 생성되는 컨트롤은 새로 만들기 탭에 표시되며 수정할 컨트롤은 수정됨 탭에 표시됩니다.

5. 가져오기를 클릭합니다.

   새 컨트롤 및 수정된 컨트롤을 가져오기 위해 장기 실행 작업이 시작됩니다.

6. 가져오기 작업이 완료되면 활동 상태 창의 컨트롤 탭에 작업 상태가 표시됩니다. 메시지 창에서 표시를 클릭하거나 특정 통합 작업의 상태 보기의 안내에 따라 활동 상태 창을 엽니다.