設定語意排名器,並在搜尋結果中回傳說明

註

Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。

Important

本文中標示為(預覽)的功能或特性目前處於公開預覽狀態,並受 Microsoft Azure 預覽版補充使用條款的約束。

有關 Foundry IQ(Azure AI 搜尋服務)專屬的預覽條款,請參閱預覽功能。

語意排名會對初始結果集進行迭代,採用第二語言排名方法,將語意相關的結果提升到堆疊頂端。 你也可以獲得語意標籤,以強調最相關的術語和片語,以及語意 答案。

本文說明如何設定語意重排序的搜尋索引。

註

如果你有現有的程式碼呼叫預覽版或先前的 API 版本,請參閱 「遷移語意排名程式碼」 以獲得修改程式碼的協助。

先決條件

選擇客戶

你可以在新設或現有索引上指定語意配置,使用以下任何工具與軟體開發套件(SDK)來新增語意配置:

新增語意配置

有些工作負載會自動建立語意配置。 如果你使用 代理式擷取,並且在 Foundry IQ 上使用 為內容建立索引的知識來源,你產生的索引已經有一套適用於你內容的語意設定。

Tip

從 API 版本開始 2026-05-01-preview ,支援的代理檢索知識庫流程不需要明確的語意設定。 此例外不適用於經典語意排名查詢或較舊的 API 版本。 欲了解更多資訊,請參閱 建立搜尋索引知識來源。

其他工作負載,你可以自己設定語意配置。 語意配置是你索引中的一個區塊,用來建立用於語意排序的欄位輸入。 你可以隨時新增或更新語意設定,無需重建。 如果你建立多個設定,可以指定預設值。 在查詢時,請在 查詢請求中指定語意設定,或保持空白以使用預設值。

你可以在單一索引中建立多達 100 種語意配置。

語意配置有一個名稱及以下特性:

財產 特徵
標題欄位 一串短字,理想是25字以內。 此欄位可以是文件標題、產品名稱或唯一識別碼。 如果你沒有合適的欄位,就留空。
內容欄位 較長的自然語言文本區塊,受到機器學習模型 最大詞元輸入限制。 常見的例子包括文件正文、產品描述或其他自由形式文字。
關鍵字欄位 關鍵字清單,例如文件上的標籤,或描述性詞彙,例如項目的類別。

你只能指定一個標題欄位,但你可以設定任意數量的內容和關鍵字欄位。 對於內容和關鍵字欄位,請依優先順序列出,因為優先權較低的欄位可能會被截斷。

在所有語意配置屬性中,你指派的欄位必須是:

  • 歸因於 searchable 和 retrievable
  • 類型為 Edm.String、Collection(Edm.String) 和 Edm.ComplexType 的字串子欄位
  1. 前往 Azure 入口網站中的 Foundry IQ 服務。

  2. 在左側導覽窗格的 索引 中,選擇一個索引。

  3. 選擇語 意配置 ,然後選擇 新增語意配置。

    螢幕擷取圖顯示在 Azure 入口網站中新增語意設定的選項。

  4. 在 新的語意配置 頁面,輸入語意配置名稱,並選擇語意配置中要使用的欄位。 只有可搜尋且可檢索的字串欄位才符合資格。 務必依優先順序列出內容欄位和關鍵字欄位。

    螢幕截圖示範如何在 Azure 入口網站中建立語意設定。

  5. 選擇 儲存 以儲存設定。

  6. 在索引頁面再次選擇 儲存 ,以儲存索引中的語意設定。

選擇加入預發布語意排名模型(預覽)

利用提供該屬性的 preview REST API 以及預覽Azure SDK,你可以選擇性地設定索引,使其使用預發布的語意排名模型(如果在你的區域部署)。 沒有機制能知道是否有預釋版本,或是否用於特定查詢。 因此,我們建議你在測試環境中使用此特性,且僅限於你有興趣嘗試最新語意排名模型時。

配置屬性為 "flightingOptIn": true,且設定在索引的語意配置區塊中。 該屬性預設為空或假。 你可以隨時在建立或更新請求中設定為真,且這會影響未來的語意查詢,前提是查詢規定包含該屬性的語意設定。

PUT https://myservice.search.windows.net/indexes('hotels')?allowIndexDowntime=False&api-version=2026-11-01-preview

{
  "name": "hotels",
  "fields": [ ],
  "scoringProfiles": [ ],
  "defaultScoringProfile": "geo",
  "suggesters": [ ],
  "analyzers": [ ],
  "corsOptions": { },
  "encryptionKey": { },
  "similarity": { },
  "semantic": {
    "configurations": [
      {
        "name": "semanticHotels",
        "prioritizedFields": {
          "titleField": {
            "fieldName": "hotelName"
          },
        "prioritizedContentFields": [
            {
              "fieldName": "description"
            },
            {
              "fieldName": "description_fr"
            }
          ],
        "prioritizedKeywordsFields": [
            {
              "fieldName": "tags"
            },
            {
              "fieldName": "category"
            }
          ],
        "flightingOptIn": true
        }
      }
    ]
  },
  "vectorSearch": {  }
}

下一步

透過執行語意查詢來測試你的語意設定。