검색 결과에서 의미 체계 순위 및 반환 캡션 구성

아티클
02/28/2024

이 문서에서는 결과 집합에 대해 의미 순위매기기를 호출하여 의미 체계상 가장 관련성이 높은 결과를 스택 맨 위로 승격하는 방법을 알아봅니다. 또한 가장 관련성이 높은 용어 및 문구에 대한 강조 표시와 의미론적 답변이 있는 의미론적 캡션을 얻을 수 있습니다.

필수 조건

지역 가용성에 따라 기본, 표준 계층(S1, S2, S3) 또는 스토리지 최적화 계층(L1, L2)의 Search Service입니다.
의미 순위매기기는 Search Service에서 사용하도록 설정됩니다.
서식 있는 텍스트 콘텐츠가 포함된 기존 검색 인덱스입니다. 의미 순위매기기는 텍스트(비벡터) 필드에 적용되며 정보 제공 또는 설명이 포함된 콘텐츠에 가장 잘 작동합니다.

클라이언트 선택

의미 체계 순위를 지원하는 검색 클라이언트를 선택합니다. 다음은 몇 가지 옵션입니다.

Azure Portal: 인덱스 디자이너를 사용하여 의미 체계 구성을 추가합니다.
REST 클라이언트를 사용하여 Visual Studio Code
.NET용 Azure SDK
Python용 Azure SDK
Java용 Azure SDK
JavaScript용 Azure SDK

의미 체계 구성 추가

의미 체계 구성은 의미 순위매기기에 대한 필드 입력을 설정하는 인덱스의 섹션입니다. 다시 빌드할 필요 없이 언제든지 의미 체계 구성을 추가하거나 업데이트할 수 있습니다. 여러 구성을 만드는 경우 기본값을 지정할 수 있습니다. 쿼리 시 쿼리 요청에 의미 체계 구성을 지정하거나 기본값을 사용하려면 공백으로 남겨둡니다.

의미 체계 구성에는 이름과 다음 속성이 있습니다.

속성	특성
제목 필드	짧은 문자열(이상적으로는 25단어 미만)입니다. 이 필드는 문서 제목, 제품 이름 또는 고유 식별자일 수 있습니다. 적합한 필드가 없으면 공백으로 둡니다.
콘텐츠 필드	기계 학습 모델의 최대 토큰 입력 제한이 적용되는 자연어 형식의 더 긴 텍스트 청크입니다. 일반적인 예로는 문서 본문, 제품 설명 또는 기타 자유 형식 텍스트가 있습니다.
키워드 필드	문서의 태그와 같은 키워드 목록 또는 항목 범주와 같은 설명 용어입니다.

제목 필드는 하나만 지정할 수 있지만 콘텐츠 및 키워드 필드는 원하는 만큼 지정할 수 있습니다. 콘텐츠 및 키워드 필드의 경우 우선 순위가 낮은 필드가 잘리기 때문에 필드를 우선 순위 순서로 나열합니다.

모든 의미 체계 구성 속성에서 할당하는 필드는 다음과 같아야 합니다.

searchable 및 retrievable로 표시됨
Edm.String, Collection(Edm.String) 형식의 문자열, Collection(Edm.ComplexType)의 문자열 하위 필드

Azure Portal에 로그인하고 의미 순위매기기가 사용하도록 설정된 Search Service로 이동합니다.
왼쪽 탐색 창의 인덱스에서 인덱스를 엽니다.
의미 체계 구성을 선택한 다음, 의미 체계 구성 추가를 선택합니다.

제목 필드, 콘텐츠 필드 및 키워드 필드를 선택하는 옵션이 있는 새 의미 체계 구성 페이지가 열립니다. 검색 가능하고 조회 가능한 문자열 필드만 적합합니다. 콘텐츠 필드와 키워드 필드를 우선 순위에 따라 나열해야 합니다.

확인을 선택하여 변경 내용을 저장합니다.

인덱스 만들기 또는 업데이트 요청을 작성합니다.

scoringProfiles 또는 suggesters 뒤에 오는 인덱스 정의에 의미 체계 구성을 추가합니다. 기본값을 지정하는 것은 선택 사항이지만 구성이 두 개 이상인 경우 유용합니다.

"semantic": {
    "defaultConfiguration": "my-semantic-config-default",
    "configurations": [
        {
            "name": "my-semantic-config-default",
            "prioritizedFields": {
                "titleField": {
                    "fieldName": "HotelName"
                },
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ],
                "prioritizedKeywordsFields": [
                    {
                        "fieldName": "Tags"
                    }
                ]
            }
        },
                    {
            "name": "my-semantic-config-desc-only",
            "prioritizedFields": {
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ]
            }
        }
    ]
}

.NET용 Azure SDK에서 SemanticConfiguration 클래스를 사용합니다.

다음 예는 Azure SDK 팀이 작성한 의미 순위매기기 샘플에서 가져온 것입니다.

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

미리 보기 버전에서 마이그레이션

의미 순위매기기 코드가 미리 보기 API를 사용하는 경우 이 섹션에서는 안정적인 버전으로 마이그레이션하는 방법을 설명합니다. 일반 공급 확인을 위해 변경 로그를 확인할 수 있습니다.

동작 변경 내용:

2023년 7월 14일 현재 의미 순위매기기는 언어에 구애받지 않습니다. 특정 언어에 대한 바이어스 없이 다국어 콘텐츠로 구성된 결과의 순위를 다시 매길 수 있습니다. 미리 보기 버전에서는 의미 순위매기기 필드 분석기에서 지정한 언어와 다른 결과의 우선 순위 지정을 낮춥니다.
2021-04-30-Preview 및 모든 이후 버전에서 REST API 및 동일한 버전을 대상으로 하는 모든 SDK 패키지의 경우: semanticConfiguration(인덱스 정의에서)은 의미 순위매기기에 사용되는 검색 필드를 정의합니다. 이전 2020-06-30-Preview REST API에서는 필드 지정 및 우선 순위 지정에 searchFields(쿼리 요청)가 사용되었습니다. 이 방식은 2020-06-30-Preview에서만 작동했으며 다른 모든 버전에서는 더 이상 사용되지 않습니다.

1단계: queryLanguage 제거

의미 순위매기기 엔진은 이제 언어에 구애받지 않습니다. 쿼리 논리에 queryLanguage가 지정된 경우 더 이상 의미 순위매기기에 사용되지 않지만 맞춤법 교정에는 계속 적용됩니다.

맞춤법 검사기를 사용하고 언어 값이 맞춤법 검사기에 의해 지원되는 경우에는 queryLanguage를 유지합니다. 맞춤법 검사는 언어별로 제한적으로 제공됩니다.

그렇지 않으면 queryLanguage를 삭제합니다.

2단계: `searchFields`를 `semanticConfiguration`으로 바꾸기

코드가 2020-06-30-Preview REST API 또는 해당 REST API 버전을 대상으로 하는 베타 SDK 패키지를 호출하는 경우 의미 체계 필드 및 우선 순위를 지정하기 위해 쿼리 요청에 searchFields를 사용할 수 있습니다. 초기 베타 버전에서 searchFields는 초기 쿼리를 searchFields에 나열된 필드로 제한하고 의미 순위매기기가 사용된 경우 필드 우선 순위 지정을 설정하는 두 가지 목적을 가졌습니다. 이후 버전에서는 searchFields가 원래 목적을 보존하지만 더 이상 의미 순위매기기에 사용되지 않습니다.

전체 텍스트 검색을 명명된 필드 목록으로 제한하기 위해 사용하는 경우 쿼리 요청에 searchFields를 유지합니다.

이 문서의 지침에 따라 필드 우선 순위를 지정하려면 인덱스 스키마에 semanticConfiguration을 추가합니다.

다음 단계

의미 체계 쿼리를 실행하여 의미 체계 구성을 테스트합니다.

의미 체계 쿼리 만들기