Note
Azure AI 搜尋服務 可透過 Azure 入口網站、REST API 及 Azure SDK 取得。 它同時也是 Foundry IQ 的基礎，這是一個管理式知識層，能將企業內容轉化為可重複使用、權限感知的知識庫，供 Microsoft Foundry 入口網站中的代理使用。
Azure AI 搜尋服務 會定期推出功能更新。 有時候 (但並不一定)，這些更新會需要新版本的 API，以維持回溯相容性。 發行新版本可讓您控制在程式碼中整合搜尋服務更新的時機與方式。
一般來說，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-Preview
- 2014-07-31-Preview
- 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.搜尋。文件 12 | Active | 更新日誌 | 服務上資料平面作業的 API，例如內容和對象的讀寫作業。 |
| Azure。ResourceManager.Search | Active | 更新日誌 | 搜尋服務上控制平面作業的 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/搜尋文件 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函式庫套件、程式碼和文件的連結。