Azure AI 검색의 쿼리에 의미 체계 순위 지정 추가

검색 탐색기에는 의미 체계 순위에 대한 옵션이 포함되어 있습니다.

1. Azure Portal에 로그인합니다.

2. 검색 인덱스 열기 및 검색 탐색기를 선택합니다.

3. 쿼리 옵션을 선택합니다. 의미 체계 구성을 이미 정의한 경우 기본적으로 선택됩니다. 인덱스가 없는 경우 인덱스의 의미 체계 구성을 만듭니다.

   

4. "좋은 음식이 있는 역사적인 호텔"과 같은 쿼리를 입력하고 검색을 선택합니다.

5. 또는 JSON 보기를 선택하고 쿼리 편집기에 정의를 붙여넣습니다.

   

   보기에 붙여넣을 수 있는 JSON 텍스트는 다음과 같습니다.

    {
        "queryType": "semantic",
        "search": "historic hotel with good food",
        "semanticConfiguration": "my-semantic-config",
        "answers": "extractive|count-3",
        "captions": "extractive|highlight-true",
        "highlightPreTag": "<strong>",
        "highlightPostTag": "</strong>",
        "select": "HotelId,HotelName,Description,Category",
        "count": true
    }
   

문서 검색을 사용하여 요청을 작성합니다.

응답에는 자동으로 @search.rerankerScore가 포함됩니다. 응답에 캡션 또는 답변을 원하는 경우 요청에 캡션과 답변을 추가합니다.

이 섹션의 다음 예에서는 hotels-sample-index를 사용하여 의미 체계 답변 및 캡션을 사용하여 의미 체계 순위를 보여줍니다.

1. 다음 요청을 웹 클라이언트에 템플릿으로 붙여넣습니다. 서비스 이름 및 인덱스 이름을 유효한 값으로 바꿉니다.

   POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2024-07-01      
   {
       "queryType": "semantic",
       "search": "newer hotel near the water with a great restaurant",
       "semanticConfiguration": "my-semantic-config",
       "answers": "extractive|count-3",
       "captions": "extractive|highlight-true",
       "highlightPreTag": "<strong>",
       "highlightPostTag": "</strong>",
       "select": "HotelId,HotelName,Description,Category",
       "count": true
   }
   

2. "queryType"을 "semantic"으로 설정합니다.

3. "검색"을 전체 텍스트 검색 쿼리로 설정합니다. 검색 문자열은 단순한 구문 또는 전체 Lucene 구문을 지원할 수 있습니다. 의미 체계 순위 지정은 전체 텍스트 검색의 확장이므로 "검색"은 필수는 아니지만 비어 있는 검색("search": "*")인 경우 예상한 결과를 가져올 수 없습니다.

4. "semanticConfiguration"을 인덱스에 포함된 미리 정의된 의미 체계 구성으로 설정합니다.

5. 의미 체계 답변을 결과에 포함할지 여부를 지정하려면 "answers"를 설정합니다. 현재 이 매개 변수에 대한 유일한 유효 값은 extractive입니다. 답변은 최대 10개를 반환하도록 구성할 수 있습니다. 기본값은 1개입니다. 이 예제에서는 extractive|count-3의 세 가지 답변을 보여 줍니다.

   모든 요청에 대한 답변이 보장되지는 않습니다. 답변을 얻으려면 쿼리는 질문 형식으로 작성해야 하며, 내용에는 답변 형식의 텍스트가 포함되어야 합니다.

6. 의미 체계 캡션을 결과에 포함할지 여부를 지정하려면 "captions"를 설정합니다. 현재 이 매개 변수에 대한 유일한 유효 값은 extractive입니다. 강조 표시를 사용하거나 사용하지 않고 결과를 반환하도록 캡션을 구성할 수 있습니다. 기본값은 강조 표시를 반환하는 것입니다. 이 예는 강조 표시가 없는 캡션(extractive|highlight-false)을 반환합니다.

   캡션 및 답변의 기초는 "semanticConfiguration"에서 참조되는 필드입니다. 이러한 필드는 2,000개 토큰 또는 약 20,000자의 범위에서 결합된 제한에 속합니다. 이 제한을 초과하는 토큰 수를 예상하는 경우 텍스트 분할 기술을 사용하여 데이터 청크 분할 단계를 고려합니다. 이 방법은 AI 보강 파이프라인 및 인덱서에 대한 종속성을 도입합니다.

7. 캡션에 적용되는 기본 강조 표시 서식을 재정의하려면 "highlightPreTag" 및 "highlightPostTag"를 설정합니다.

   캡션을 사용하면 응답이 요약된 문서의 주요 구절에 강조 표시 서식이 적용됩니다. 기본값은 <em>입니다. 서식 유형(예: 노란색 배경)을 지정하려면 highlightPreTag와 highlightPostTag를 설정하면 됩니다.

8. 응답에 반환되는 필드를 지정하려면 "select"를 설정하고 인덱스의 일치 항목 수를 반환하는 "count"를 설정합니다. 이러한 매개변수는 요청의 품질과 응답의 가독성을 개선합니다.

9. 요청을 보내 쿼리를 실행하고 결과를 반환합니다.

QueryType 또는 SemanticQuery를 사용하여 의미 체계 쿼리에서 의미 순위매기기를 호출합니다. 다음 예제는 Azure SDK 팀의 예제입니다.

SearchResults<Hotel> response = await searchClient.SearchAsync<Hotel>(
    "Is there any hotel located on the main commercial artery of the city in the heart of New York?",
    new SearchOptions
    {
        SemanticSearch = new()
        {
            SemanticConfigurationName = "my-semantic-config",
            QueryCaption = new(QueryCaptionType.Extractive),
            QueryAnswer = new(QueryAnswerType.Extractive)
        },
        QueryLanguage = QueryLanguage.EnUs,
        QueryType = SearchQueryType.Semantic
    });

int count = 0;
Console.WriteLine($"Semantic Search Results:");

Console.WriteLine($"\nQuery Answer:");
foreach (QueryAnswerResult result in response.SemanticSearch.Answers)
{
    Console.WriteLine($"Answer Highlights: {result.Highlights}");
    Console.WriteLine($"Answer Text: {result.Text}");
}

await foreach (SearchResult<Hotel> result in response.GetResultsAsync())
{
    count++;
    Hotel doc = result.Document;
    Console.WriteLine($"{doc.HotelId}: {doc.HotelName}");

    if (result.SemanticSearch.Captions != null)
    {
        var caption = result.SemanticSearch.Captions.FirstOrDefault();
        if (caption.Highlights != null && caption.Highlights != "")
        {
            Console.WriteLine($"Caption Highlights: {caption.Highlights}");
        }
        else
        {
            Console.WriteLine($"Caption Text: {caption.Text}");
        }
    }
}
Console.WriteLine($"Total number of search results:{count}");