맞춤 탐색 결과 받기

탐색은 탐색 메서드를 사용하여 최종 사용자가 선택한 카테고리 또는 필터와 일치하는 검색 결과를 표시합니다. 탐색은 맞춤설정할 수 있는 결과를 반환합니다. 이 페이지에서는 일반 검색 데이터 스토어의 둘러보기 결과를 가져오는 방법을 설명합니다.

둘러보기 정보

AI 애플리케이션 검색 앱에서 탐색이란 검색어를 사용하지 않거나 검색어를 비워두고 검색하는 것을 의미합니다. 정형 데이터, 메타데이터가 포함된 비정형 데이터 또는 웹사이트 데이터가 포함된 일반 검색 데이터 스토어가 있는 경우 빈 검색어를 전송하여 둘러보기 결과를 수신할 수 있습니다.

둘러보기 요청을 전송하면 필터와 일치하는 데이터 스토어의 문서가 이벤트 기반 신호에 따라 반환됩니다. 다음을 실행하여 향상된 탐색 환경을 제공할 수 있습니다.

  • 검색 요청에 필터를 사용하여 검색 결과의 범위를 좁힙니다. 고급 웹사이트 색인 생성을 사용하는 경우 고급 웹사이트 색인 생성에 구조화된 데이터 사용에서 스키마에 메타데이터를 추가하고 이를 사용하여 필터 및 부스트 필드를 보강하는 방법을 알아보세요.
  • 특정 결과를 상단으로 올리거나 하단으로 내림으로써 반환된 결과의 순서에 영향을 미치는 부스트 사양을 추가합니다.
  • 사용자 이벤트를 이해하고 기록합니다. Google은 사용자 이벤트를 사용하여 클릭률에 맞게 결과 순위를 최적화합니다.

다음 표에는 검색과 탐색의 차이점이 나와 있습니다.

기능 검색 찾아보기
목적 특정 정보 찾기 콘텐츠 탐색
예 Google 검색에서 '밴쿠버 최고의 한국 음식점' 검색 '식당 > 한국식 > 밴쿠버 > 4성급 이상'과 같이 레스토랑이 속할 수 있는 카테고리를 기준으로 레스토랑을 둘러봅니다.
사용자 의도 일반적으로 목표 지향적 탐색적
시작점 일반적으로 검색창에 있는 검색어 또는 키워드 일반적으로 메뉴, 탐색경로, 링크 또는 섹션과 같은 기타 탐색 방법을 사용하는 특정 웹사이트 또는 플랫폼
메서드 키워드 또는 문구를 입력하고 검색 및 게재 구성을 적용합니다. 빈 쿼리로 검색하고 검색 및 게재 구성 적용
결과 관련 검색결과 목록 필터와 일치하는 데이터 스토어의 모든 문서

웹사이트 데이터가 있는 앱의 둘러보기 결과 가져오기

API를 사용하여 웹사이트 데이터가 있는 앱의 둘러보기 결과를 가져오려면 다음 단계를 따르세요.

  1. 앱 ID를 찾습니다. 앱 ID를 이미 알고 있는 경우 다음 단계로 건너뜁니다.

    1. Google Cloud 콘솔에서 AI 애플리케이션 페이지로 이동합니다.

      앱으로 이동

    2. 앱 페이지에서 앱 이름을 찾고 ID 열에서 앱 ID를 가져옵니다.

  2. 다음과 같이 빈 쿼리 또는 쿼리가 없는 상태로 engines.servingConfigs.search 메서드를 호출합니다.

    REST

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"orderBy": "ORDER_BY",
"params": {
     "searchType": "0"
 },
"filter": "FILTER",
"boostSpec": "BOOST_SPEC",
}'

    다음을 바꿉니다.

    • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
    • APP_ID: 쿼리할 Vertex AI Search 앱의 ID입니다.
    • ORDER_BY: 선택사항입니다. 결과가 정렬되는 순서입니다. 정렬할 속성은 숫자로 표현되어야 합니다(예: date). 자세한 내용은 웹 검색 결과 정렬을 참고하세요.
    • FILTER: 선택사항이지만 권장됩니다. 필터 표현식을 사용하여 검색을 필터링하기 위한 텍스트 필드입니다. 기본값은 빈 문자열입니다. filter 필드 사용에 관한 자세한 내용은 정형 또는 비정형 데이터의 일반 검색 필터링 및 웹사이트 검색 필터링을 참고하세요.
    • BOOST_SPEC: 선택사항입니다. 문서 순위를 상승시키거나 하강시키는 사양입니다. 값:
      • BOOST: [-1,1] 범위의 부동 소수점 숫자입니다. 값이 음수이면 결과가 강등되어 결과 하단에 표시됩니다. 값이 양수이면 결과가 승격하여 결과 상단에 표시됩니다.
      • CONDITION: 텍스트 필터 표현식으로, 부스트를 적용할 문서를 선택합니다. 필터는 불리언 값으로 평가되어야 합니다. 정형 검색의 순위 상승에 대한 자세한 내용은 검색 결과 상승을 참조하세요.

    다음과 같이 잘린 응답과 비슷한 JSON 응답이 수신됩니다. 응답에는 검색 요청에 설정된 필드에 따라 결정된 순서로 나열된 항목별 검색 결과가 포함됩니다.