在 Azure AI 搜尋中建立語意查詢

發行項
03/08/2024

在本文中，瞭解如何在結果集上叫用語意排名，將最語意相關的結果提升至堆疊頂端。您也可以取得語意標題，其中包含最相關詞彙和片語的醒目提示，以及語意答案。

必要條件

具有語意排名的搜尋服務、基本層或更高層級。
具有語意組態和 RTF 內容的現有搜尋索引。
如果您需要功能簡介，請檢閱語意排名。

注意

標題和答案會從搜尋檔中的文字中逐字擷取。語意子系統會使用機器閱讀理解來辨識具有標題或答案特性的內容，但不會撰寫新的句子或片語語。基於這個理由，包含說明或定義的內容最適合用於語意排名。如果您要與產生的回應進行聊天樣式互動，請參閱擷取擴增世代（RAG）。

選擇用戶端

選擇支援語意排名的搜尋用戶端。以下列出一些選項：

避免略過相關性評分的功能

Azure AI 搜尋中的數個查詢功能會略過相關性評分，否則與語意排名不相容。如果您的查詢邏輯包含下列功能，則無法以語意方式排序結果：

具有 search=* 或空白搜尋字串的查詢，例如純篩選查詢，將無法運作，因為沒有任何可測量語意相關性。查詢必須提供可在處理期間評估的字詞或片語。
以完整 Lucene 語法撰寫queryType=full的查詢與語意排名（queryType=semantic）不相容。語意模型不支援完整的 Lucene 語法。
特定欄位的排序（orderBy 子句）會覆寫搜尋分數和語意分數。假設語意分數應該提供排名，如果您將語意排名套用至已排序的結果，新增 orderby 子句會導致 HTTP 400 錯誤。

設定查詢

在此步驟中，將參數新增至查詢要求。若要成功，您的查詢應該是全文搜索（使用 search 參數傳入字串），而且索引應該包含具有豐富語意內容和語意組態的文字欄位。

搜尋總管包含語意排名的選項。

登入 Azure 入口網站。
開啟搜尋索引，然後選取 [搜尋總管]。
選取 [ 查詢選項]。如果您已經定義語意組態，預設會選取它。如果您沒有語意組態，請為您的索引建立語意組態。
輸入查詢，例如「具有良好食物的歷史酒店」，然後選取 [ 搜尋]。

或者，選取 [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 來示範語意答案和標題的語意排名。

將下列要求貼到 Web 用戶端作為範本。以有效值取代服務名稱和索引名稱。

POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2023-11-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
}

將「queryType」設定為「semantic」。

在其他查詢中，會使用「queryType」來指定查詢剖析器。在語意排名中，它會設定為「semantic」。。針對 [搜尋] 欄位，您可以指定符合簡單語法的查詢。
根據簡單語法，將「search」設定為全文搜索查詢。語意排名是全文搜索的延伸，因此，雖然不需要此參數，但如果它是 Null，則不會取得預期的結果。
將「semanticConfiguration」設定為內嵌在索引中的預先定義語意組態。
設定「answers」以指定結果中是否包含語意答案。目前，此參數 extractive的唯一有效值為。答案可以設定為傳回最多10個。預設值為一。此範例顯示三個答案的計數： extractive|count-3。

每個要求都不能保證答案。若要取得答案，查詢看起來必須類似問題，而且內容必須包含看起來像答案的文字。
設定「標題 s」以指定結果中是否包含語意標題。目前，此參數 extractive的唯一有效值為。標題可以設定為傳回具有或沒有醒目提示的結果。預設值是傳回醒目提示。本範例會傳回沒有醒目提示的標題：extractive|highlight-false。

標題和答案的基礎是「semanticConfiguration」中所參考的字段。這些欄位在 2,000 個標記的範圍或大約 20,000 個字元的結合限制下。如果您預期令牌計數超過此限制，請考慮使用文字分割技能的數據區塊化步驟。這種方法引進了對 AI 擴充管線和索引器的相依性。
如果您想要覆寫套用至標題的預設醒目提示格式，請設定「highlightPreTag」和「highlightPostTag」。。

標題會將醒目提示格式套用至摘要回應之檔中的關鍵段落。預設值為 <em>。如果您想要指定格式設定的類型（例如黃色背景），您可以設定 highlightPreTag 和 highlightPostTag。
設定「select」以指定回應中傳回哪些欄位，而「count」則會傳回索引中的相符項目數目。這些參數可改善要求的品質，以及回應的可讀性。
傳送要求以執行查詢並傳回結果。

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

評估回應

只有來自初始結果的前 50 個相符專案可以語意排名。如同所有查詢，回應是由標示為可擷取的所有欄位所組成，或只包含選取參數中列出的字段。回應包含原始相關性分數，也可能包含計數或批次結果，視您制定要求的方式而定。

在語意排名中，回應有更多的元素：新的語意排名相關性分數、純文本中的選擇性標題，以及醒目提示和選擇性答案。如果您的結果不包含這些額外的元素，您的查詢可能會設定錯誤。在針對問題進行疑難解答的第一個步驟中，請檢查語意組態，以確保它在索引定義和查詢中都指定。

在用戶端應用程式中，您可以建構搜尋頁面，以包含標題做為相符專案的描述，而不是特定欄位的整個內容。當個別欄位對搜尋結果頁面來說太密集時，這個方法很有用。

上述範例查詢的回應會傳回下列相符專案做為最上層選擇。系統會傳回標題，因為已設定「標題 s」屬性，並具有純文字和醒目提示的版本。系統會從範例中省略答案，因為無法判斷此特定查詢和主體的答案。

"@odata.count": 35,
"@search.answers": [],
"value": [
    {
        "@search.score": 1.8810667,
        "@search.rerankerScore": 1.1446577133610845,
        "@search.captions": [
            {
                "text": "Oceanside Resort. Luxury. New Luxury Hotel. Be the first to stay. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
                "highlights": "<strong>Oceanside Resort.</strong> Luxury. New Luxury Hotel. Be the first to stay.<strong> Bay</strong> views from every room, location near the pier, rooftop pool, waterfront dining & more."
            }
        ],
        "HotelName": "Oceanside Resort",
        "Description": "New Luxury Hotel. Be the first to stay. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
        "Category": "Luxury"
    },
  ...
]

下一步

語意排名可用於混合式查詢，將關鍵詞搜尋和向量搜尋結合成單一要求和統一回應。

具有語意排名的混合式查詢