검색 기본사항

Cloud Talent Solution을 사용하면 Cloud Talent Solution의 색인에 저장된 채용정보를 검색할 수 있습니다. 이 문서에서는 Cloud Talent Solution의 여러 가지 검색 방법과 관련 서비스에 대해 설명합니다.

검색 요청

채용정보 검색을 요청하려면 jobs:search 엔드포인트에 POST 요청을 보내 본문에 검색 데이터를 전달합니다.

필수 필드

다음은 필수 필드입니다.

  • searchMode: 적용할 채용정보 검색 유형을 지정합니다. 옵션은 다음과 같습니다.

    • JOB_SEARCH: 기본값이며 권장되는 검색 모드입니다. 모든 채용정보를 대상으로 검색합니다. 가장 관련성이 높은 채용정보를 검색어와 관련된 순서대로 반환합니다.
    • FEATURED_JOB_SEARCH: promotionValue가 0보다 큰 채용정보만 검색합니다. 결과는 promotionValue 내림차순으로 정렬되며 해당 값이 동일한 경우 관련성을 기준으로 정렬됩니다. 자세한 내용은 추천 채용정보를 참조하세요.

일반적으로 사용되는 필드

  • JobQuery: 검색할 채용정보 기준을 지정합니다. 여기에는 위치, 채용정보 카테고리, 고용 유형, 텍스트 쿼리, 회사 등이 포함됩니다. 자세한 내용은 검색 필터를 참조하세요.

  • requestMetadata: 이 검색 요청에 대한 사용자 및 세션 정보를 포함합니다. 자세한 내용은 RequestMetadata를 참조하세요.

  • jobView: 일치하는 각 채용정보에 대해 반환되는 필드의 수를 정의합니다. JOB_VIEW_SMALL(기본값), JOB_VIEW_MINIMAL 또는 JOB_VIEW_FULL로 설정할 수 있습니다. 각 옵션에 대한 설명은 JobView 참조를 확인하세요.

  • orderBy: 반환되는 채용정보의 정렬 순서입니다. 허용되는 값은 참조를 확인하세요. 관련성에 따른 내림차순(RELEVANCE_DESC) 정렬이 기본 설정입니다.

관련성 임계값 및 위치/카테고리 확장

검색 시 더 많은 채용정보를 반환하려면 다음 두 필드를 사용하여 관련성에 대한 제한을 완화하세요.

  • enableBroadening: 이 필드를 true로 설정하면 검색 요청의 위치 및 채용정보 카테고리에 대한 제한을 완화하여 더 많은 결과를 반환할 수 있습니다. 예를 들어 검색 요청에서 워싱턴 주의 한 도시를 선택하고 해당 지역의 반경 2마일 이내에 있는 채용정보를 지정한 경우 이 플래그를 true로 설정하면 워싱턴 주에 속한 다른 도시의 채용정보도 반환될 수 있습니다.

  • disableKeywordMatch: 이 플래그는 기본적으로 false입니다. 이 플래그를 false로 설정하면 Cloud Talent Solution에서 제목 또는 설명이 쿼리 문자열과 정확히 일치하는 채용정보뿐 아니라 검색어와 관련성이 있는 채용정보도 추가로 반환합니다.

RequestMetadata

모든 검색 및 히스토그램 요청에는 RequestMetadata 객체가 포함되어야 합니다. 이 객체에는 검색을 시작하는 사용자에 대한 정보가 포함되어 있습니다.

이 객체가 중요한 이유는 다음과 같습니다.

  • 사용자 일관성. Cloud Talent Solution은 검색 관련성을 높이기 위해 여러 버전의 기본 모델을 동시에 실행합니다. 이 필드를 채우면 구직자에게 일관된 환경을 제공할 수 있습니다. Cloud Talent Solution은 userId, sessionId, domain에 따라 식별된 구직자에게 일관된 환경을 보장합니다. 참고: 이러한 필드는 난독화되어야 합니다.

  • 검색 개선.조정 알고리즘은 사용자가 제공하는 구직자 데이터와 함께 RequestMetadata 필드에 제공된 정보를 기반으로 합니다. 이는 검색결과의 관련성을 개선합니다.

검색 연산자

연산자 설명
( ) 하나 이상의 키워드를 그룹화합니다.
AND 해당 연산자의 양쪽에 있는 키워드 또는 키워드 그룹과 관련된 결과를 검색합니다.
OR 해당 연산자의 어느 한쪽에 있는 키워드 또는 키워드 그룹과 관련된 결과를 검색합니다.
NOT 해당 연산자 바로 다음 괄호 안에 있는 키워드 또는 키워드 그룹과 관련된 결과를 제외합니다.
- 해당 연산자 다음에 추가된 키워드 또는 키워드 그룹과 관련된 결과를 제외합니다.

예를 들면 다음과 같습니다.

  • "software OR java"는 메타데이터에 'software' 또는 'java'가 포함된 채용정보를 반환합니다.

  • "software" -java는 'software'와 관련된 채용정보를 반환하지만 'java'와 관련된 채용정보는 제외합니다.

  • "(software OR java) AND (marketing)"은 'software'와 'marketing' 관련 채용정보 및 'java'와 'marketing' 관련 채용정보를 반환합니다.

구직자 쿼리

검색어는 실제 채용정보 관련 항목으로도 감지될 수 있습니다. 예를 들어 'intern'으로 쿼리한 경우 Cloud Talent Solution은 이 검색어를 'INTERN' 고용 유형으로 취급하여 EMPLOYMENT_TYPE이 INTERN인 채용정보만 필터링합니다. 따라서 채용정보 설명에는 'intern'이 들어 있지만 고용 유형이 다른 값으로 설정된 채용정보는 반환되지 않습니다.

문제해결

각 검색 요청은 시스템에서 고유한 검색 requestID를 생성하며, 이 ID는 해당 검색 및 응답의 매개변수를 추적하는 데 사용됩니다. 이 ID는 특정한 검색 및 CRUD 요청과 관련된 문제를 해결하는 데 중요하므로 적절히 로깅되어야 합니다. requestId검색 응답 본문ResponseMetadata 필드 안에 반환됩니다. 관련된 CRUD 호출 응답 객체에 반환될 수도 있습니다.

관련성, 검색, 색인 생성 등과 관련하여 지원을 문의하려면 지원팀에 티켓을 제출하면서 관련 요청 ID 또는 요청 자체를 포함하시기 바랍니다.

결과 수

결과 수는 구직자에게 검색결과의 수를 알리는 데 사용됩니다. 결과 수가 히스토그램 결과 또는 실제 반환된 채용정보의 수와 항상 일치하지는 않습니다.

페이지 나누기

페이지 나누기는 Cloud Talent Solution에서 'offset' 매개변수 또는 검색 요청의 nextPageToken 필드를 사용하여 구현할 수 있습니다. 오프셋 필드는 결과 목록의 첫 번째 채용정보로부터의 오프셋을 지정하는 데 사용됩니다. '소프트웨어 엔지니어'를 검색하여 관련 채용정보가 100개로 계산된 경우를 예로 들어 보겠습니다. 초기 검색 요청에서 pageSize 필드를 10으로 설정하면 반환되는 채용정보의 수를 처음 10개로 제한할 수 있습니다. 구직자가 결과에서 2페이지를 클릭하면 두 번째 검색을 호출하면서 오프셋 필드를 10으로 설정하여 10번째 위치부터 다음 결과 세트를 가져올 수 있습니다.

nextPageToken 필드를 사용하는 동안 검색 요청은 pageSize를 허용하며, 반환된 searchJobsResponse에는 fieldSize와 다음 결과 세트에 따라 nextPageToken 필드의 반환 시작 지점을 표시하는 nextPageToken이 포함됩니다. pageToken과 pageSize를 통해 이미 지정된 것보다 결과가 더 많은 경우, API 사용자는 검색 요청을 다시 호출하면서 pageToken을 이전에 얻은 nextPageToken으로 설정하여 더 많은 결과를 가져올 수 있습니다. 결과의 1페이지를 처음 검색하는 경우에는 Null로 설정하면 됩니다.

페이지 크기는 20 이하로 제한하는 것이 좋습니다. 페이지가 이보다 크면 지연 시간이 가중되어 API 성능이 저하될 수 있습니다. 또한 구직자에게 렌더링되는 페이지당 한 번씩 검색을 호출하는 것이 좋습니다. 단일 검색 호출로 많은 수의 채용정보를 반환하고 클라이언트 측에서 페이지를 나누는 방법을 사용하면 머신러닝 모델이 채용정보 분석 프레임워크를 통해 정확히 학습하지 못할 수 있습니다.

맞춤법 검사

맞춤법 검사는 맞춤법이 틀렸을 가능성이 있는 검색어를 찾아서 수정하고 수정된 쿼리에 따른 결과를 반환하는 Cloud Talent Solution 검색 요청의 기능입니다. 예를 들어 맞춤법 검사를 사용하는 경우 구직자가 'manager' 대신 'manaer'를 검색하면 Cloud Talent Solution은 'manager'에 맞는 채용정보를 반환합니다. 맞춤법 검사는 검색 요청의 disableSpellCheck 필드를 설정하여 활성화 또는 비활성화할 수 있습니다. 맞춤법 검사가 활성화된 경우 수정된 쿼리는 spellResult 필드의 검색 응답에서 확인할 수 있습니다.