圖形搜尋結果 - Azure AI Search | Microsoft Learn

link之家
链接快照平台
输入网页链接，自动生成快照
标签化管理网页链接
用於定義查詢回應的用戶端和 API

您可以使用下列客戶端來設定查詢回應：
使用 JSON 檢視在 Azure 入口網站中搜尋總管，以便您可以指定任何支持的參數檔案 - POST （REST API） SearchClient.Search 方法（Azure SDK for .NET） SearchClient.Search 方法（適用於 Python 的 Azure SDK） SearchClient.Search 方法（適用於 JavaScript 的 Azure） SearchClient.Search 方法（適用於 Java 的 Azure）
結果主要是表格式，由所有 retrievable 欄位的欄位組成，或僅限於參數中指定的 select 欄位。數據列是相符的檔，通常依相關性順序排序，除非您的查詢邏輯排除相關性排名。
您可以選擇搜尋結果中包含哪些欄位。雖然搜尋文件可能包含大量的欄位，但通常只需要幾個欄位來表示結果中的每個文件。在查詢要求上，附加 select=<field list> 以指定 retrievable 回應中應該出現的欄位。
挑選提供檔對比和差異的欄位，提供足夠的資訊來邀請使用者部分的點擊鏈接回應。在電子商務網站上，其可能是產品名稱、描述、品牌、色彩、大小、價格和評等。針對內建旅館範例索引，其可能是下列範例中的「選取」欄位：
POST /indexes/hotels-sample-index/docs/search?api-version=2024-07-01 
      "search": "sandy beaches",
      "select": "HotelId, HotelName, Description, Rating, Address/City",
      "count": true
未預期結果的提示
有時候，查詢輸出不是您預期看到的輸出。 例如，您可能會發現某些結果似乎重複，或「應該」出現在頂端附近的結果卻在結果中的較低位置。 當查詢結果不是預期的結果時，您可以嘗試進行下列查詢修改，看看結果是否有所改善：

將 searchMode=any (預設值) 變更為 searchMode=all，以要求須符合所有準則，而非任何準則。 此做法在查詢中包含布林運算子時特別有用。
試驗不同的語彙分析器或自訂分析器，來查看其是否變更查詢結果。 默認分析器會中斷連字元字組，並將單字減少為根窗體，這通常可改善查詢回應的健全性。 不過，如果您需要保留連字號，或如果字串包含特殊字元，您可能需要設定自訂分析器，以確保索引包含正確格式的權杖。 如需詳細資訊，請參閱部分字詞搜尋和具有特殊字元 (連字號、萬用字元、RegEx、模式) 的模式。
計算相符項目數
參數 count 會傳回索引中被視為符合查詢的檔數目。 若要傳回計數，請將 count=true 新增至查詢要求。 沒有搜尋服務強加的最大值。 根據您的查詢和文件的內容，計數可能與索引中的每個文件一樣高。
當索引穩定時，計數是正確的。 如果系統正在主動新增、更新或刪除檔，則計數是近似的，不包括未完整編製索引的任何檔。
計數不會受到例行維護或搜尋服務上其他工作負載的影響。 不過，如果您有多個分割區和單一複本，在分割區重新啟動時，您可能會遇到文件計數的短期波動 (數分鐘)。
若要檢查索引編制作業，您可以藉由在空白搜尋 count=true 查詢上新增 search=*，以確認索引是否包含預期的文件數目。 結果是索引中文件的完整計數。
測試查詢語法時，count=true 可以快速告訴您，您的修改會傳回更多還是更少的結果，這可能是很實用的回饋。
回應中的結果數目
Azure AI 搜尋會使用伺服器端分頁來防止查詢一次擷取太多檔。 判斷回應中結果數目的查詢參數為 top 和 skip。 
              top 是指頁面中的搜尋結果數目。 
              skip 是 的 top間隔，它會告訴搜尋引擎在取得下一個集合之前要略過多少結果。
默認頁面大小為 50，而頁面大小上限為 1,000。 如果您指定的值大於1,000，且在索引中找到超過1,000個結果，則只會傳回前1,000個結果。 如果相符項目數目超過頁面大小，回應會包含擷取下一頁結果的資訊。 例如：
"@odata.nextLink": "https://contoso-search-eastus.search.windows.net/indexes/realestate-us-sample-index/docs/search?api-version=2024-07-01"
頂端相符專案取決於搜尋分數，假設查詢是全文搜索或語意。 否則，最上層相符專案是精確比對查詢的任意順序（其中統 @search.score=1.0 一表示任意排名）。
設定 top 為覆寫預設值 50。 在較新的預覽 API 中，如果您使用混合式查詢，您可以指定 maxTextRecallSize 來傳回最多 10,000 份文件。
若要控制結果集中傳回之所有文件的分頁，請使用 top 和 skip 一起使用。 此查詢會傳回第一組 15 個相符檔，加上總相符專案計數。
POST https://contoso-search-eastus.search.windows.net/indexes/realestate-us-sample-index/docs/search?api-version=2024-07-01
    "search": "condos with a view",
    "count": true,
    "top": 15,
    "skip": 0
此查詢會傳回第二組，略過前 15 個取得下一個 15 （16 到 30）：
POST https://contoso-search-eastus.search.windows.net/indexes/realestate-us-sample-index/docs/search?api-version=2024-07-01
    "search": "condos with a view",
    "count": true,
    "top": 15,
    "skip": 15
如果基礎索引會變，則不保證編頁查詢會有穩定結果。 分頁會變更每個頁面的 skip 值，但每個查詢都是獨立的，而且會在資料的目前檢視上運作，因為其會在查詢時存在於索引中 (換句話說，沒有結果的快取或快照集，例如在一般用途資料庫中找到的結果)。
以下是您可能會取得重複項目的範例。 假設一個索引有四份文件：
{ "id": "1", "rating": 5 }
{ "id": "2", "rating": 3 }
{ "id": "3", "rating": 2 }
{ "id": "4", "rating": 1 }
現在假設您想要一次傳回兩個結果，依評等排序。 您會執行此查詢來取得結果的第一頁：$top=2&$skip=0&$orderby=rating desc，這會產生下列結果：
{ "id": "1", "rating": 5 }
{ "id": "2", "rating": 3 }
在服務上，假設在查詢呼叫之間將第五份文件新增至索引：{ "id": "5", "rating": 4 }。  不久之後，您會執行查詢來擷取第二頁：$top=2&$skip=2&$orderby=rating desc，並取得下列結果：
{ "id": "2", "rating": 3 }
{ "id": "3", "rating": 2 }
請注意，會擷取文件 2 兩次。 這是因為新文件 5 具有更高的評等值，所以其排序在文件 2 之前，並登陸第一頁。 儘管此行為可能是非預期的，但通常是搜尋引擎的行為方式。
對大量結果進行分頁
分頁的替代方法是使用 排序順序 和 範圍篩選 作為的因應措施 skip。
在此因應措施中，排序和篩選條件會套用於文件識別碼欄位或每個文件唯一的另一個欄位。 唯一欄位在搜尋索引中必須具有 filterable 和 sortable 屬性。
發出查詢以傳回已排序結果的完整頁面。
POST /indexes/good-books/docs/search?api-version=2024-07-01
      "search": "divine secrets",
      "top": 50,
      "orderby": "id asc"
選擇搜尋查詢傳回的最後一個結果。 這裡只會顯示標識碼值的範例結果。
    "id": "50"
使用範圍查詢中的該標識碼值來擷取下一頁的結果。 此標識符欄位應具有唯一值，否則分頁可能包含重複的結果。
POST /indexes/good-books/docs/search?api-version=2024-07-01
      "search": "divine secrets",
      "top": 50,
      "orderby": "id asc",
      "filter": "id ge 50"
當查詢傳回零個結果時，分頁就會結束。
              filterable和 sortable 屬性只能在欄位第一次新增至索引時啟用，無法在現有的欄位上啟用它們。
在全文搜索查詢中，結果可依下列項目進行排名：
語意重新排名器分數
欄位上的 sortable 排序順序
您也可以藉由新增評分設定檔來提升特定欄位中找到的任何相符項目。
依搜尋分數排序
針對全文搜索查詢，結果會 使用 BM25 演演算法自動依搜尋分數 進行排名，並根據字詞頻率、檔長度和平均文件長度計算。
範圍 @search.score 是未系結的，或 0 到舊版服務的 1.00（但不包括） 1.00。
針對任一演算法， @search.score 等於1.00表示未記錄或未加入的結果集，其中1.0分數在所有結果中都是統一的。 當查詢形式為模糊搜尋、萬用字元或 RegEx 查詢，或空搜尋 (search=*) 時，就會出現未評分的結果。 如果您需要對未評分的結果強加排名結構，orderby 運算式將協助您達成該目標。
依語意重新排名器排序
如果您使用 語意排名器，則 @search.rerankerScore 決定結果的排序順序。
範圍 @search.rerankerScore 是 1 到 4.00，其中較高的分數表示更強的語意比對。
使用 orderby 排序
如果一致的排序是應用程式需求，您可以在欄位上明確定義 orderby 運算式。 只有將索引編製為「可排序」的欄位可以用來排序結果。
通常用於 orderby 的欄位包含評等、日期和位置。 除了欄位名稱之外，依位置篩選需要篩選運算式呼叫 geo.distance() 函式。
數值欄位 （Edm.Double、 、 Edm.Int32Edm.Int64） 會依數值順序排序（例如 1、2、10、11、20）。
字串欄位 （Edm.String， Edm.ComplexType 子字段） 會 根據語言，以 ASCII 排序順序 或 Unicode 排序順序排序。
字串欄位中的數值內容是依字母順序排序 (1、10、11、2、20)。
大寫字串的排序在小寫字串之前 (APPLE、Apple、BANANA、Banana、apple、banana)。 您可以指派文字正規化程式，在排序之前預先處理文字來變更此行為。 在欄位上使用小寫Tokenizer不會影響排序行為，因為 Azure AI 搜尋會在字段的非分析複本上排序。
以變音符號開頭的字串最後出現 (Äpfel、Öffnen、Üben)
使用評分設定檔提升相關性
提升順序一致性的另一種方法是使用自訂評分設定檔。 評分設定檔可讓您更充分掌控搜尋結果中的項目排名，並能夠提升在特定欄位中找到的相符項目。 額外的評分邏輯有助於覆寫複本之間的次要差異，因為每個文件的搜尋分數會相距更遠。 我們建議對此方法使用排名演算法。
搜尋結果醒目提示
點擊醒目提示是指將文字格式 (例如粗體或黃色醒目提示) 套用至結果中的相符字詞，讓您輕鬆找出相符項目。 醒目提示適用於較長的內容欄位，例如描述欄位，其中相符項目不是顯而易見。
請注意，醒目提示會套用至個別字詞。 沒有醒目提示功能針對整個欄位的內容。 如果您想要在片語上反白顯示，您必須在引號括住的查詢字串中提供相符的字詞（或片語）。 本節會進一步描述這項技術。
              查詢要求上會提供點擊醒目提示指示。 觸發引擎中查詢擴充的查詢 (例如模糊和萬用字元搜尋) 對點擊醒目提示的支援有限。
點擊醒目提示的需求
欄位必須是 Edm.String 或 Collection(Edm.String)
欄位必須屬性於 searchable
在要求中指定醒目提示
若要傳回醒目提示的字詞，請在查詢要求中包含 highlight 參數。 參數會設定為以逗號分隔的欄位清單。
根據預設，格式標記為 <em>，但您可以使用 highlightPreTag 和 highlightPostTag 參數覆寫標籤。 您的用戶端程式碼會處理回應 (例如，套用粗體字型或黃色背景)。
POST /indexes/good-books/docs/search?api-version=2024-07-01
      "search": "divine secrets",  
      "highlight": "title, original_title",
      "highlightPreTag": "<b>",
      "highlightPostTag": "</b>"
根據預設，Azure AI 搜尋服務最多可傳回每個欄位五個醒目提示。 您可以附加後面跟著整數的虛線來調整此數目。 例如，在描述欄位中傳 "highlight": "description-10" 回最多 10 個醒目提示字詞的相符內容。
醒目提示的結果
將醒目提示新增至查詢時，回應會包含 @search.highlights 每個結果的，讓應用程式程式代碼可以將該結構設為目標。 回應中包含針對 「醒目提示」指定的欄位清單。
在關鍵字搜尋中，系統會個別掃描每個字詞。 「神聖秘密」的查詢會傳回任何包含任一字詞的檔相符專案。
關鍵字搜尋醒目提示
在醒目提示的欄位中，格式化會套用至整個字詞。 例如，在比對 "The Divine Secrets of the Ya-Ya Sisterhood" 時，即使連續，也會個別將格式套用至每個字詞。
"@odata.count": 39,
"value": [
        "@search.score": 19.593246,
        "@search.highlights": {
            "original_title": [
                "<em>Divine</em> <em>Secrets</em> of the Ya-Ya Sisterhood"
            "title": [
                "<em>Divine</em> <em>Secrets</em> of the Ya-Ya Sisterhood"
        "original_title": "Divine Secrets of the Ya-Ya Sisterhood",
        "title": "Divine Secrets of the Ya-Ya Sisterhood"
        "@search.score": 12.779835,
        "@search.highlights": {
            "original_title": [
                "<em>Divine</em> Madness"
            "title": [
                "<em>Divine</em> Madness (Cherub, #5)"
        "original_title": "Divine Madness",
        "title": "Divine Madness (Cherub, #5)"
        "@search.score": 12.62534,
        "@search.highlights": {
            "original_title": [
                "Grave <em>Secrets</em>"
            "title": [
                "Grave <em>Secrets</em> (Temperance Brennan, #5)"
        "original_title": "Grave Secrets",
        "title": "Grave Secrets (Temperance Brennan, #5)"
片語搜尋醒目提示
整個字詞格式即使在片語搜尋上也適用，其中多個字詞會以雙引號括住。 下列範例是相同的查詢，不同之處在於，"divine secrets" 是以引號括住的片語形式提交 (某些 REST 用戶端，要求您使用反斜線 \" 逸出內部引號)：
POST /indexes/good-books/docs/search?api-version=2024-07-01 
      "search": "\"divine secrets\"",
      "select": "title,original_title",
      "highlight": "title",
      "highlightPreTag": "<b>",
      "highlightPostTag": "</b>",
      "count": true
因為準則現在有這兩個詞彙，搜尋索引中只會找到一個相符專案。 上一個查詢的回應如下所示：
    "@odata.count": 1,
    "value": [
            "@search.score": 19.593246,
            "@search.highlights": {
                "title": [
                    "<b>Divine</b> <b>Secrets</b> of the Ya-Ya Sisterhood"
            "original_title": "Divine Secrets of the Ya-Ya Sisterhood",
            "title": "Divine Secrets of the Ya-Ya Sisterhood"
舊版服務上的片語醒目提示
在 2020 年 7 月 15 日之前建立的搜尋服務會針對片語查詢實作不同的醒目提示體驗。
針對下列範例，假設查詢字串包含引號括住的片語 "super bowl"。 在 2020 年 7 月之前，片語中的任何字詞都會醒目提示：
"@search.highlights": {
    "sentence": [
        "The <em>super</em> <em>bowl</em> is <em>super</em> awesome with a <em>bowl</em> of chips"
針對在 2020 年 7 月之後建立的搜尋服務，只會在 中 @search.highlights傳回符合完整片語查詢的片語：
"@search.highlights": {
    "sentence": [
        "The <em>super</em> <em>bowl</em> is super awesome with a bowl of chips"
若要為您的用戶端快速產生搜尋頁面，請考慮下列選項：
              在 Azure 入口網站 中建立示範應用程式，以搜尋列、多面向導覽和縮圖區域建立 HTML 頁面，如果您有影像。
              將搜尋新增至 ASP.NET Core (MVC) 應用程式是建置功能用戶端的教學課程和程式碼範例。

              將搜尋新增至 Web 應用程式 是使用 React JavaScript 連結庫進行用戶體驗的 C# 教學課程和程式代碼範例。 應用程式是使用 Azure Static Web Apps 部署，並實作分頁。