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

의미 체계 순위 지정은 초기 결과 집합을 반복하여 의미 체계로 가장 관련성이 높은 결과를 스택 맨 위로 승격시키는 L2 순위 지정 방법론을 적용합니다. 또한 가장 관련성이 높은 용어 및 문구에 대한 강조 표시와 의미론적 답변이 있는 의미론적 캡션을 얻을 수 있습니다.

이 문서에서는 의미론적 순위 재지정을 위해 검색 인덱스를 구성하는 방법을 설명합니다.

참고 항목

미리 보기 또는 이전 API 버전을 호출하는 기존 코드가 있는 경우 코드 수정에 대한 도움말은 마이그레이션 의미 체계 순위 코드를 참조하세요.

필수 조건

• 기본 계층 이상의 검색 서비스로, 사용 가능 여부는 지역에 따라 다릅니다.

• 의미 순위매기기는 Search Service에서 사용하도록 설정됩니다.

• 서식 있는 텍스트 콘텐츠가 포함된 기존 검색 인덱스입니다. 의미론적 순위 지정은 문자열(비벡터) 필드에 적용되며 정보 제공 또는 설명용 콘텐츠에 가장 효과적입니다.

클라이언트 선택

다음 도구 및 SDK(소프트웨어 개발 키트)를 사용하여 의미 체계 구성을 추가하여 새 인덱스 또는 기존 인덱스에 대한 의미 체계 구성을 지정할 수 있습니다.

• Azure Portal: 인덱스 디자이너를 사용하여 의미 체계 구성을 추가합니다.
• REST 클라이언트 및 REST(인덱스 만들기 또는 업데이트) API를 사용하는 Visual Studio Code입니다.
• .NET용 Azure SDK
• Python용 Azure SDK
• Java용 Azure SDK
• JavaScript용 Azure SDK

의미 체계 구성 추가

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

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

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

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

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

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

Azure Portal

1. Azure Portal에 로그인하고 의미 순위매기기가 사용하도록 설정된 Search Service로 이동합니다.

2. 왼쪽 탐색 창의 인덱스에서 인덱스를 선택합니다.

3. 의미 체계 구성을 선택한 다음, 의미 체계 구성 추가를 선택합니다.

   

4. 새 의미 체계 구성 페이지에서 의미 체계 구성 이름을 입력하고 의미 체계 구성에 사용할 필드를 선택합니다. 검색 가능하고 조회 가능한 문자열 필드만 적합합니다. 콘텐츠 필드와 키워드 필드를 우선 순위에 따라 나열해야 합니다.

   

5. 저장을 선택하여 구성 설정을 저장합니다.

6. 인덱스 페이지에서 다시 저장을 선택하여 인덱스의 의미 체계 구성을 저장합니다.

REST API

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

2. 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 SDK

.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")
                }
            })
        }
    }
};

다음 단계

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

의미 체계 쿼리 만들기