고급 자동 완성 구성

이 페이지에서는 AI Applications의 고급 자동 완성 기능을 설명합니다.

기본 자동 완성과 마찬가지로 고급 자동 완성은 쿼리에 입력된 처음 몇 글자를 기반으로 쿼리 추천을 생성합니다.

이 페이지를 읽기 전에 AI 애플리케이션의 기본 자동 완성 기능을 숙지하세요. 자동 완성 구성을 참조하세요.

고급 자동 완성의 주요 기능

고급 자동 완성의 주요 기능은 기본 자동 완성과 다음과 같이 다릅니다.

  • 혼합 검색: 고급 자동 완성은 혼합 검색 앱과 함께 사용할 수 있습니다. 혼합 검색 앱은 두 개 이상의 데이터 스토어에 연결된 맞춤 검색 앱입니다.

  • 액세스 제어: 고급 자동 완성은 액세스 제어를 준수합니다. (액세스 제어는 ACL, 액세스 제어 목록이라고도 합니다.) 고급 자동 완성 기능은 검색자가 액세스할 수 있는 문서와 관련된 검색어만 추천합니다. 액세스 제어에 대한 자세한 내용은 데이터 소스 액세스 제어 사용을 참고하세요.

  • 언어 부스트: 고급 자동 완성을 설정하여 하나 이상의 언어로 추천을 부스트할 수 있습니다. 예를 들어 브라우저 언어가 네덜란드어인 경우 해당 언어의 자동 완성 추천 용어가 부스트될 수 있습니다. 자세한 내용은 언어 부스트를 사용하여 자동 완성 요청 보내기를 참조하세요.
  • 최근 쿼리: 고급 자동 완성 기능을 사용하면 일반 자동 완성 쿼리 추천 대신 사용자가 입력한 문자와 프리픽스가 일치하는 최근 쿼리를 얻을 수 있습니다. 자세한 내용은 자동 완성 요청 보내기 및 최근 쿼리 반환을 참고하세요.

시작하기 전에

고급 자동 완성 기능을 사용하기 전에 다음을 실행하세요.

  • 앱의 자동 완성 설정을 검토하고 원하는 경우 수정합니다. 자동 완성 설정 업데이트를 참고하세요.

  • 소규모 데이터 스토어의 경우 자동 완성 사용 설정을 지금으로 설정합니다. 작은 데이터 스토어에는 정확한 추천을 제공하기에 충분한 데이터가 없을 수 있으므로 이 방법을 사용하는 것이 좋습니다.

  • 데이터 저장소에 개인 식별 정보 (PII)가 포함되어 있거나 검색 기록 또는 사용자 이벤트 쿼리 추천 모델을 사용하는 경우 PII 유출 방지를 검토하고 PII 유출을 방지하는 데 필요할 수 있는 데이터 손실 방지 (DLP) 보호 조치를 설정하세요.

자동 완성 요청 보내기

다음은 completionConfig.completeQuery 메서드를 사용하여 고급 자동 완성 요청을 보내는 방법을 보여줍니다.

REST

API를 사용하여 자동 완성 요청을 보내려면 다음 단계를 수행합니다.

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

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

      앱으로 이동

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

  1. completionConfig.completeQuery 메서드를 호출합니다.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING"
    }'

    다음을 바꿉니다.

    • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.

    • APP_ID: Vertex AI Search 앱의 ID입니다.

    • QUERY_STRING: 추천 용어를 가져오는 데 사용되는 typeahead 입력입니다.

언어 부스트를 사용하여 자동 완성 요청 보내기

언어 코드에 따라 자동 완성 추천 용어를 부스트하거나 숨길 수 있습니다. 예를 들어 일부 언어의 자동 완성 추천 용어가 표시될 가능성을 높이거나 낮출 수 있습니다.

부스트 값은 -1에서 1 사이여야 합니다. 음수를 설정하면 해당 언어의 자동 완성 추천 용어를 '숨기고' 양수를 설정하면 해당 언어를 부스트합니다.

BCP 47에 정의된 두 글자 언어 태그를 사용합니다(예: en, fr, hi, zh).

REST

언어 부스트 값이 포함된 자동 완성 요청을 보내려면 다음 단계를 따르세요.

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

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

      앱으로 이동

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

  1. completionConfig.completeQuery 메서드를 호출합니다.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "boostSpec": {
         "conditionBoostSpecs": [{
           "condition": "(langCode: ANY(LANG_CODE))",
           "boost": BOOST_VALUE
         }]
      }
    }'

    다음을 바꿉니다.

    • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.

    • APP_ID: Vertex AI Search 앱의 ID입니다.

    • QUERY_STRING: 추천 용어를 가져오는 데 사용되는 typeahead 입력입니다.

    • LANG_CODE: 하나 이상의 언어에 대한 두 글자 코드입니다(이스케이프된 따옴표로 표시). 예를 들어 \"fr\", \"es\"는 스페인어 및 프랑스어에 부스트 값을 적용합니다.

    • BOOST_VALUE: -1~1 사이의 부동 소수점 숫자입니다. 값이 음수이면 해당 언어의 자동 추천 순위가 내려가 추천 목록에서 아래쪽에 표시되고, 값이 양수이면 추천이 승격되어 목록 상단에 표시됩니다.

자동 완성 요청을 전송하고 최근 쿼리 반환

요청의 쿼리와 프리픽스가 일치하는 사용자의 가장 최근 쿼리 목록을 추천으로 반환합니다.

일치하는 쿼리 추천은 최신부터 오래된 순으로 나열됩니다. 최근 검색을 사용하려면 사용자 유사 ID를 제공해야 합니다.

예

직원이 휴가에 대한 정보를 얻기 위해 회사 인트라넷 사이트를 쿼리하고 있습니다. 직원이 다음 쿼리를 실행했으며, 최신 쿼리부터 가장 오래된 쿼리 순으로 나열되어 있습니다.

PTO, Vacation blackout periods, How much vacation time do I have?, Time off, Vacation policy, covering a vacant position during absences, Can I take unpaid time off?

이제 직원이 검색창에 vac를 입력하면 자동 완성 추천 용어는 다음과 같습니다.

  • Vacation blackout periods
  • How much vacation time do I have?
  • Vacation policy
  • Covering a vacant position during absences

절차

사용자의 가장 최근 쿼리를 반환하는 자동 완성 요청을 보내려면 다음 단계를 따르세요.

REST

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

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

      앱으로 이동

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

  1. completionConfig.completeQuery 메서드를 호출합니다.

    
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "suggestionTypes": ["RECENT_SEARCH"],
      "userPseudoId": "USER_PSEUDO_ID"
    }'

    다음을 바꿉니다.

    • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.

    • APP_ID: Vertex AI Search 앱의 ID입니다.

    • QUERY_STRING: 추천 용어를 가져오는 데 사용되는 typeahead 입력입니다.

    • USER_PSEUDO_ID: 사용자의 가명 식별자입니다. 이 필드에는 단일 기기의 방문자를 고유하게 식별하는 HTTP 쿠키를 사용할 수 있습니다. 여러 사용자에 대해 이 필드를 동일한 식별자로 설정하지 마세요. 이렇게 하면 쿼리 기록이 결합됩니다. 이 필드에는 개인 식별 정보(PII)를 포함하지 마세요.

자동 완성 차단 목록 사용

차단 목록을 사용하여 특정 용어가 자동 완성 추천 용어에 표시되지 않게 할 수 있습니다.

고급 자동 완성은 앱 수준이지만 차단 목록은 데이터 스토어 수준입니다. 이는 앱이 혼합 검색 앱인 경우 중요합니다. 앱에 연결된 각 데이터 스토어의 차단 목록을 만듭니다.

차단 목록 만들기 및 사용에 관한 자세한 내용은 자동 완성 차단 목록 사용을 참조하세요.

가져온 자동 완성 추천 목록 사용

자동 완성 데이터 모델에서 생성된 자동 완성 추천 대신 자체 자동 완성 추천 목록을 제공할 수 있습니다.

목록을 가져오는 방법에 대한 자세한 내용은 가져온 자동 완성 추천 목록 사용하기를 참고하세요.