맞춤 탐색 결과 받기

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

탐색 정보

AI Applications 검색 앱에서 탐색은 쿼리 없이 또는 빈 쿼리로 검색하는 것입니다. 구조화된 데이터, 메타데이터가 포함된 비정형 데이터 또는 웹사이트 데이터가 포함된 일반 검색 데이터 스토어가 있는 경우 빈 검색어를 전송하여 탐색 결과를 수신할 수 있습니다.

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

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

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

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

웹사이트 데이터가 있는 앱의 탐색 결과 가져오기

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 응답이 수신됩니다. 응답에는 검색 요청에 설정된 필드에 따라 결정된 순서로 나열된 항목별 검색 결과가 포함됩니다.