註
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。
Important
本文中標示為(預覽)的功能或特性目前處於公開預覽狀態,並受 Microsoft Azure 預覽版補充使用條款的約束。
有關 Foundry IQ(Azure AI 搜尋服務)專屬的預覽條款,請參閱預覽功能。
語意排名會對初始結果集進行迭代,採用第二語言排名方法,將語意相關的結果提升到堆疊頂端。 你也可以獲得語意標籤,以強調最相關的術語和片語,以及語意 答案。
本文說明如何設定語意重排序的搜尋索引。
註
如果你有現有的程式碼呼叫預覽版或先前的 API 版本,請參閱 「遷移語意排名程式碼」 以獲得修改程式碼的協助。
先決條件
任何提供語意排名的區域中的 Foundry IQ(Azure AI 搜尋服務)。
一個包含豐富文字內容的現有搜尋索引。 語意排序適用於字串(非向量)欄位,效果最佳於資訊性或描述性內容。
在 Foundry IQ 上建立及使用物件的權限。 我們建議使用 基於角色的存取,但如果角色指派不可行,也可以使用 API 金鑰 。 如需更多資訊,請參閱 「連接至 Foundry IQ 服務」。
Search Service REST API 的 2026-11-01-preview 版本。
選擇客戶
你可以在新設或現有索引上指定語意配置,使用以下任何工具與軟體開發套件(SDK)來新增語意配置:
- Azure 入口網站,使用索引設計器新增語意設定。
- 使用搭配 REST 用戶端 和 建立或更新索引(REST)API 的 Visual Studio Code。
- Azure SDK for .NET
- Azure SDK for Python
- Azure SDK for Java
- Azure SDK for JavaScript
新增語意配置
有些工作負載會自動建立語意配置。 如果你使用 代理式擷取,並且在 Foundry IQ 上使用 為內容建立索引的知識來源,你產生的索引已經有一套適用於你內容的語意設定。
Tip
從 API 版本開始 2026-05-01-preview ,支援的代理檢索知識庫流程不需要明確的語意設定。 此例外不適用於經典語意排名查詢或較舊的 API 版本。 欲了解更多資訊,請參閱 建立搜尋索引知識來源。
其他工作負載,你可以自己設定語意配置。 語意配置是你索引中的一個區塊,用來建立用於語意排序的欄位輸入。 你可以隨時新增或更新語意設定,無需重建。 如果你建立多個設定,可以指定預設值。 在查詢時,請在 查詢請求中指定語意設定,或保持空白以使用預設值。
你可以在單一索引中建立多達 100 種語意配置。
語意配置有一個名稱及以下特性:
| 財產 | 特徵 |
|---|---|
| 標題欄位 | 一串短字,理想是25字以內。 此欄位可以是文件標題、產品名稱或唯一識別碼。 如果你沒有合適的欄位,就留空。 |
| 內容欄位 | 較長的自然語言文本區塊,受到機器學習模型 最大詞元輸入限制。 常見的例子包括文件正文、產品描述或其他自由形式文字。 |
| 關鍵字欄位 | 關鍵字清單,例如文件上的標籤,或描述性詞彙,例如項目的類別。 |
你只能指定一個標題欄位,但你可以設定任意數量的內容和關鍵字欄位。 對於內容和關鍵字欄位,請依優先順序列出,因為優先權較低的欄位可能會被截斷。
在所有語意配置屬性中,你指派的欄位必須是:
- 歸因於
searchable和retrievable - 類型為
Edm.String、Collection(Edm.String)和Edm.ComplexType的字串子欄位
前往 Azure 入口網站中的 Foundry IQ 服務。
在左側導覽窗格的 索引 中,選擇一個索引。
選擇語 意配置 ,然後選擇 新增語意配置。
在 新的語意配置 頁面,輸入語意配置名稱,並選擇語意配置中要使用的欄位。 只有可搜尋且可檢索的字串欄位才符合資格。 務必依優先順序列出內容欄位和關鍵字欄位。
選擇 儲存 以儲存設定。
在索引頁面再次選擇 儲存 ,以儲存索引中的語意設定。
選擇加入預發布語意排名模型(預覽)
利用提供該屬性的 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": { }
}
下一步
透過執行語意查詢來測試你的語意設定。