在 Azure AI 搜尋中將語意排名新增至查詢

發行項
06/28/2024

本文說明如何在查詢上叫語意排名工具。如果您的搜尋文件包含字串欄位，且向量查詢具有文字表示，您可以將語意排名套用至文字查詢、混合式查詢和向量查詢。

語意排名會逐一查看初始結果集，並套用 L2 排名方法，將語意上最相關的結果提升至堆疊頂端。您也可以取得語意標題，其中反白顯示最相關的字詞和片語，以及語意答案。

必要條件

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

注意

會從搜尋文件中的文字擷取標題和答案。語意子系統會使用機器閱讀理解來識別具有標題或答案特性的內容，但其不會撰寫新的句子或片語。因此，包含說明或定義的內容最適用於語意排名。如果您要與產生的回應進行聊天樣式互動，請參閱擷取擴增生成 (RAG)。

選擇用戶端

您可以使用下列任何工具和 SDK 來建置使用語意排名的查詢：

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

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" 為 [語意]。

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

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

標題和答案的基礎是 "semanticConfiguration" 中所參考的欄位。這些欄位的組合限制為 2,000 個語彙基元或大約 20,000 個字元。如果您預期語彙基元計數會超過此限制，請考慮使用文字分割技能執行資料區塊化步驟。這種方法帶來對 AI 擴充管線和索引子的相依性。
如果您想要覆寫套用至標題的預設反白顯示格式，請設定 "highlightPreTag" 和 "highlightPostTag"。

標題會將白顯示格式套用至文件中摘要回應的主要段落。預設值為 <em>。如果您想要指定格式設定的類型 (例如黃色背景)，您可以設定 highlightPreTag 和 highlightPostTag。
設定 [選取] 為指定回應中傳回的欄位，而 "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 個相符項目可以以語意方式設定優先順位。如同所有查詢項目，回應是由標示為可擷取的所有欄位所組成，或只包含指定參數中列出的欄位。回應包含原始相關性分數，也可能包含計數或批次結果，視您制定要求的方式而定。

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

在用戶端應用程式中，您可以建構搜尋分頁，包含標題作為相符項目的說明，而不是特定欄位的整個內容。當個別欄位對搜尋結果分頁而言太密集時，此方法很有用。

上述範例查詢的回應會傳回下列相符項目做為首選。系統會傳回標題，因為已設定「標題」屬性，且具有純文字和反白顯示的版本。因為無法判斷此特定查詢和主體的答案，所以會從範例中省略答案。

"@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"
    },
  ...
]

預期的工作負載

針對語意排名，您應該預期搜尋服務支援每個複本最多 10 個同時查詢。

如果磁碟區太高，服務會節流語意排名要求。包含這些片語的錯誤訊息表示服務具有語意排名的容量：

Error in search query: Operation returned an invalid status 'Partial Content'`
@search.semanticPartialResponseReason`
CapacityOverloaded

如果您預期輸送量需求接近、位於或高於此層級，請提出支援票證，以便我們可以為您的工作負載佈建。

下一步

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

使用語意排名的混合式查詢

共用方式為