本文會識別公開預覽版中的所有資料平面和控制平面功能。 此清單有助於檢查功能狀態。 它也說明如何呼叫預覽 REST API。
預覽 API 版本是累積的,會積存至下一個預覽版本。 建議您一律使用最新的預覽 API,以完整存取所有預覽功能。
如果預覽功能已終止或轉為一般可用性,則會從此清單中移除。 如需正式發行與淘汰的相關公告,請參閱服務更新或最新資訊。
資料平面預覽功能
| 特徵 / 功能 | Description | Availability |
|---|---|---|
| 代理程式擷取 | 打造由大型語言模型(LLM)驅動的對話式搜尋體驗。 代理檢索將複雜的使用者查詢拆解成子查詢,同時執行這些子查詢,重新排序結果以符合相關性,並提取基礎資料或將答案綜合成自然語言。 該管線在知識庫內包含一或多個知識來源,其回應承載可提供對查詢計劃和參考資料的完全透明度。 要開始,請參考 Quickstart:在 Azure AI Search 中使用代理檢索 (程式化)或快速 入門:在 Azure 入口網站使用代理檢索。 |
知識來源(預覽)、知識庫(預覽)、知識檢索(預覽)以及 Azure 入口網站 |
| Purview 索引配置 | 對基於來源元資料的索引內容套用 Microsoft Purview 分類與敏感標籤,以強化資料治理。 | 建立或更新索引(預覽) |
| 評分函數彙總 | 結合並彙整多個評分函數,實現更複雜的相關性自訂與加權訊號組合。 | 建立或更新索引(預覽) |
| Facet 彙總 | 使用總和、計數、最小值、最大值及其他彙總功能,為多面向搜尋體驗提供更強的分析。 | 搜尋文件(預覽) |
| 改進的索引子執行階段追蹤資訊 | 累積的索引器處理資訊,涵蓋搜尋服務及特定索引器。 | 取得服務統計資料 (預覽) 和取得狀態 - 索引子 (預覽) |
| 向量查詢的嚴格後置篩選 | 將 strictPostFilter 模式添加到 vectorFilterMode 參數中。 指定時,會在識別全域前 k 個向量結果之後套用篩選,以確保傳回的文件是未篩選結果的子集。 |
搜尋文件(預覽) |
| 多向量支援 | 在單一檔欄位內為多個子向量編製索引。 您現在可以在複雜集合的巢狀字段中使用向量類型,有效地允許多個向量與單一文件相關聯。 | 建立或更新索引(預覽) |
| 檔層級訪問控制 | 將文件層級的權限從 Azure Data Lake Storage (ADLS) Gen2 中的 Blob 物件傳遞到索引中可搜尋的文件。 查詢現在可以根據所選數據源的使用者身分識別來篩選結果。 | 建立或更新索引(預覽) |
| GenAI 提示技能 | 這項技能能透過你提供的提示連結到大型語言模型(LLM)以獲得資訊。 透過此技能,您可以使用 LLM 中的內容填入可搜尋的欄位。 此技能的主要使用案例是 影像語言化、使用 LLM 來描述影像,並將描述傳送至索引中的可搜尋欄位。 | 建立或更新技能組(預覽) |
| 語義配置中的 flightingOptIn 參數 | 如果搜尋服務區域內有預發布語意排名模型,請選擇使用。 | 建立或更新索引(預覽) |
| Facet 階層、彙總和 Facet 篩選 | 新的 Facet 查詢參數支援巢狀 Facet。 針對數值可 Facet 欄位,您可以加總每個欄位的值。 您也可以在 Facet 上指定篩選,以新增包含或排除準則。 | 搜尋文件(預覽) |
| 語意重排序器中的查詢重寫 | 在語意查詢上設定選項,將查詢輸入重寫為修訂或擴充的查詢,從 L2 排名器產生更相關的結果。 | 搜尋文件(預覽) |
| 無密鑰計費,用於 Azure AI 技能處理。 | 使用受控識別和角色,無金鑰連線至 Foundry Tools 來處理內建技能。 此功能消除了搜尋工具與 Foundry 工具同時存在於同一區域的限制。 | 建立或更新技能組(預覽) |
| Markdown 解析模式 | 使用此剖析模式時,索引器可以從 Azure 儲存體 中的 Markdown 檔案產生一對一或一對多的搜尋檔。 | 建立或更新索引器(預覽) |
| 將混合式搜尋中的篩選目標設為僅向量查詢 | 混合式查詢的篩選條件牽涉到要求上的所有子查詢,不論類型為何。 您可以覆寫全域篩選條件,將篩選範圍限定為特定的子查詢。 新的 filterOverride 參數會提供行為。 |
搜尋文件(預覽) |
| 文字分割技能 (權杖區塊化) | 此技能具有可改善內嵌模型之數據區塊化的新參數。 新的 unit 參數可讓您指定令牌區塊化。 您現在可以依令牌長度進行區塊化,將長度設定為對內嵌模型有意義的值。 您也可以指定權杖化工具和任何不應該在資料區塊化期間分割的權杖。 |
建立或更新技能組(預覽) |
| Azure Vision 多模態嵌入技能 | 這項技能會呼叫 Azure Vision 多模態 API,在索引過程中產生文字或圖片的嵌入。 | 建立或更新技能組(預覽) |
| Azure Machine Learning (AML) 技能 | AML 技能整合 Azure Machine Learning 的推斷端點。 在先前的預覽 API 中,其支援連線到 AML 工作區中已部署的自訂模型。 從 2025-11-01 預覽版開始,你可以在連接 Microsoft Foundry 模型目錄嵌入模型的工作流程中使用此技能。 它也可以在 Azure 入口網站中的技能集設計功能中取得,前提是 Azure AI 搜尋和 Azure 機器學習服務部署在相同的訂用帳戶中。 | 建立或更新技能組(預覽) |
| 累加擴充快取 | 將快取新增至擴充管線,可讓您在目標修改作業 (例如技能集或其他物件的更新) 不變更內容的情形下重複使用現有輸出。 快取僅適用於技能集產生的擴充文件。 | 建立或更新索引器(預覽) |
| Azure 檔案儲存體索引子 | 來自 Azure Files 的索引器索引資料來源。 | 建立或更新資料來源(預覽) |
| SharePoint 索引子 | 基於索引器進行 SharePoint 內容索引的資料來源。 | 註冊以啟用此功能。 建立或更新資料來源 (預覽) (部分機器翻譯) 或 Azure 入口網站。 |
| MySQL 索引子 | 基於索引器進行 Azure MySQL 資料來源索引的資料來源。 | 註冊以啟用此功能。 Create or Update Data Source(預覽版)、.NET SDK 11.2.1 及 Azure portal |
| Azure Cosmos DB for MongoDB 索引子 | 這是透過 Azure Cosmos DB 中 MongoDB API 進行索引器索引的資料來源。 | 註冊以啟用此功能。 建立或更新資料來源 (預覽) (部分機器翻譯) 或 Azure 入口網站。 |
| Azure Cosmos DB for Apache Gremlin 索引子 | 透過 Apache Gremlin API 在 Azure Cosmos DB 中以索引器為基礎的索引資料來源。 | 註冊以啟用此功能。 建立或更新資料來源 (預覽) |
| 原生 Blob 虛刪除 | 適用於 Azure Blob 儲存體索引子。 識別處於軟刪除狀態的 Blob,並在索引過程中移除相應的搜尋文件。 | 建立或更新資料來源 (預覽) |
| 重設文件 | 在索引子工作負載中重新處理個別選取的搜尋文件。 | 重設文件 (預覽) |
| speller | 針對簡單、完整和具有語意的查詢,在查詢字詞輸入上執行選擇性的拼字更正。 | 搜尋文件 (預覽) (部分機器翻譯)。 |
| featuresMode 參數 | BM25 相關性分數擴充以包含詳細數據:每個欄位相似度分數、每個欄位字詞頻率,以及每個欄位相符的唯一標記數目。 您可以在自訂評分解決方案中使用這些資料點。 | 搜尋文件(預覽) |
| vectorQueries.threshold 參數 | 根據最低分數排除低評分搜尋結果。 | 搜尋文件(預覽) |
| hybridSearch.maxTextRecallSize 和 countAndFacetMode 參數 | 透過控制流向混合排名模型的 BM25 排名結果數量,調整混合查詢的輸入。 | 搜尋文件(預覽) |
| moreLikeThis | 尋找與特定文件相關的文件。 這個功能已存在舊版預覽中。 | 搜尋文件(預覽) |
控制平面預覽功能
目前,預覽版中沒有控制平面功能。
Azure SDK 中的預覽功能
Azure SDK 的預覽功能可透過預覽套件取得。 要判斷特定套件版本中可用的預覽功能,請參閱 SDK 變更日誌:
- 適用於 .NET 的 Azure SDK 變更記錄
- 適用於 JAVA 的 Azure SDK 變更記錄
- 適用於 JavaScript 的 Azure SDK 變更記錄
- 適用於 Python 的 Azure SDK 變更記錄。
使用預覽功能
你可以透過預覽版 REST API 版本或預覽版 SDK 套件來存取實驗性功能。 部分功能也可能在 Azure 入口網站中提供。 欲了解更多可用性資訊,請參閱 資料平面預覽功能 與 控制平面預覽功能。
下列陳述式適用於預覽功能:
- 預覽功能可在沒有服務等級協議的補充使用規定下取得。
- 如果需要重新設計,預覽功能可能會經歷中斷性變更。
- 有時候預覽功能不會進入正式發行版本。
如果針對預覽 API 撰寫程式碼,您應該準備在較新的 API 版本推出時將該程式碼升級至該版本。我們會維護升級 REST API 文件,以簡化此步驟。
如何呼叫預覽 REST API
預覽 REST API 可透過 URI 上的 api 版本參數來存取。 舊版預覽仍在運作中,但隨著時間而過時,且不會使用新功能或錯誤修正進行更新。
若是對內容的資料平面作業,2025-11-01-preview 是最新的預覽版本。 下列範例顯示索引 GET (預覽)的語法:
GET {endpoint}/indexes('{indexName}')?api-version=2025-11-01-Preview
在對搜尋服務的管理作業中,2025-05-01-preview 是最近期的預覽版本。 下列範例顯示 Update Service 2025-05-01-preview 版本的語法。
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01-preview
{
"tags": {
"app-name": "My e-commerce app",
"new-tag": "Adding a new tag"
},
"properties": {
"replicaCount": 2
}
}