Foundry IQ(Azure AI 搜尋服務)中的 API 版本

Note

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

Foundry IQ(Azure AI 搜尋服務)會定期推出功能更新。 有時候 (但並不一定),這些更新會需要新版本的 API,以維持回溯相容性。 發佈新版本可讓您控制何時以及如何將 Foundry IQ 服務更新整合到程式碼中。

一般來說,REST API 和 Azure SDK 客戶端函式庫只有在必要時才會有版本限制,因為升級程式碼以使用新版本可能需要一些努力。 只有在以破壞回溯相容性的方式變更 API 的某些層面時,才需要新版本。 在修正現有的功能,或新功能會變更現有 API 的介面區時,就會發生這類變更。

欲了解更多關於棄用路徑的資訊,請參閱 Azure SDK 生命週期與支援政策。

已取代的版本

2023-07-01-preview 已於 2024 年 4 月 8 日棄用,並自 2024 年 7 月 8 日起不再支援。 此版本是首個提供向量搜尋支援的 REST API。 較新的 API 版本有不同的向量設定。 請盡快遷移至較新的 API 版本 或更新的 SDK 版本。

已中止版本

截至 2020 年 10 月 15 日,以下 API 版本已停止,且不再有文件或支援:

  • 2015-02-28
  • 2015-02-28-預覽
  • 2014-07-31-預覽
  • 2014-10-20-Preview

所有 SDK 都以 REST API 版本為基礎。 若某個 REST API 版本被停用,基於該版本的 SDK 套件也會停止。 所有Azure AI 搜尋服務 .NET比 3.0.0-rc 更舊的 SDK 現在都已過時。

如果你的程式碼使用已停用的版本,請 遷移到更新的 API 版本 或更新的 SDK 版本。

REST API

REST API 連結
搜尋服務 (資料平面) 請參閱 REST API 參考中的 API 版本 。
搜尋管理 (控制平面) 請參閱 REST API 參考中的 API 版本 。

適用於 .NET 的 Azure SDK

SDK 版本 狀態 Changelog 描述
Azure.Search.Documents 12 Active 更新日誌 服務上資料平面作業的 API,例如內容和對象的讀寫作業。
Azure。ResourceManager.Search Active 更新日誌 Foundry IQ 服務中控制平面操作的 API。

適用於 Java 的 Azure SDK

SDK 版本 狀態 Changelog 描述
Azure-search-documents 12 Active 更新日誌 使用 azure-search-documents 用戶端程式庫進行資料平面作業。
azure-resourcemanager-search 2 Active 更新日誌 使用 azure-resourcemanager-search 用戶端程式庫進行控制平面作業。

適用於 JavaScript 的 Azure SDK

SDK 版本 狀態 Changelog 描述
@azure/search-documents 13 Active 更新日誌 使用 @azure/search-documents 用戶端程式庫進行資料平面作業。
@azure/arm-search 4 Active 更新日誌 使用封裝 @azure/arm-search 封裝進行控制平面作業。

適用於 Python 的 Azure SDK

SDK 版本 狀態 Changelog 描述
Azure-search-documents 12 Active 更新日誌 使用 azure-search-documents 用戶端程式庫進行資料平面作業。
azure-mgmt-search 9 Active 更新日誌 使用 azure-mgmt-search 用戶端程式庫進行控制平面作業。

All Azure SDK

如果你在找測試版客戶端函式庫和文件,此頁面包含所有Azure SDK函式庫套件、程式碼和文件的連結。