在搜尋結果中設定語意排名工具優先權，並傳回標題文字

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

本文會說明如何設定搜尋索引以進行語意重新排名。

注意

如果您有呼叫預覽版或舊版 API 的現有程式代碼，請參閱 移轉語意排名程式代碼以取得修改程式碼 的說明。

必要條件

• 基本層或更高層級的搜尋服務，依區域可用性而定。

• 在您的搜尋服務上啟用語意排名工具。

• 具有 RTF 內容的現有搜尋索引。 語意排名適用於字串 (非向量) 欄位，而且最適合資訊性或描述性內容。

選擇用戶端

您可以使用下列任何工具和軟體開發工具套件 （SDK） 來新增語意組態，在新的或現有的索引上指定語意組態：

• Azure 入口網站，使用索引設計工具新增語意設定。
• Visual Studio Code 搭配 REST 用戶端和建立或更新索引 （REST） API。
• Azure SDK for .NET
• Azure SDK for Python
• Azure SDK for Java
• Azure SDK for JavaScript

新增語意設定

語意設定是索引中的區段，用於建立語意排名的欄位輸入。 您無須重建，即可隨時新增或更新語意設定。 若您建立多個設定，則可以指定預設值。 在查詢時，請在查詢要求上指定語意設定，或將其留空以使用預設值。

語意設定具有名稱和下列屬性：

屬性	特性
[標題] 欄位	簡短字串，最好少於 25 個字。 此欄位可以是文件標題、產品名稱或唯一識別碼。 若您沒有適當的欄位，請將其留空。
內容欄位	自然語言形式的較長文字區塊，受限於機器學習模型中的最大語彙基元輸入限制。 常見範例包括文件本文、產品說明或其他自由格式的文字。
關鍵字欄位	關鍵字清單，例如文件中的標籤，或描述性字詞，例如項目的類別。

您只能指定一個標題欄位，但可以隨意指定多個內容和關鍵字欄位。 對於內容和關鍵字欄位，請依優先順序列出欄位，因為優先順序較低的欄位可能會遭到截斷。

在所有語意設定屬性中，您指派的欄位必須是：

• 屬性為 searchable 和 retrievable
• Edm.String、Collection(Edm.String) 類型的字串，Edm.ComplexType 的字串子欄位

Azure 入口網站

1. 登入 [Azure 入口網站] 並瀏覽至已啟用語意排名的搜尋服務。

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

在 Azure SDK for .NET 中使用 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")
                }
            })
        }
    }
};

下一步

透過執行語意查詢，測試您的語意設定。

建立語意查詢