Wersje interfejsu API w Wyszukiwanie AI platformy Azure

Note

Wyszukiwanie AI platformy Azure jest dostępna za pośrednictwem portalu Azure, interfejsów API REST i Azure SDKs. Jest także podstawą Foundry IQ — zarządzanej warstwy wiedzy, która przekształca treści przedsiębiorstwa w bazy wiedzy wielokrotnego użytku z uwzględnieniem uprawnień dla agentów w portalu Microsoft Foundry.

Wyszukiwanie AI platformy Azure regularnie wdraża aktualizacje funkcji. Czasami jednak nie zawsze te aktualizacje wymagają nowej wersji interfejsu API w celu zachowania zgodności z poprzednimi wersjami. Publikowanie nowej wersji umożliwia kontrolowanie, kiedy i jak integrujesz aktualizacje usługi wyszukiwania w kodzie.

Z reguły interfejsy API REST i biblioteki klienckie zestawu Azure SDK są wersjonowane tylko wtedy, gdy jest to konieczne, ponieważ aktualizacja kodu w celu korzystania z nowej wersji interfejsu API może wymagać pewnego nakładu pracy. Potrzebna jest nowa wersja tylko wtedy, gdy jakiś aspekt interfejsu API uległ zmianie w sposób, który przerywa zgodność z poprzednimi wersjami. Takie zmiany mogą wystąpić z powodu poprawek istniejących funkcji lub nowych funkcji, które zmieniają istniejący obszar powierzchni interfejsu API.

Aby uzyskać więcej informacji na temat procesu wycofywania, zobacz cykl życia i politykę wsparcia Azure SDK.

Przestarzałe wersje

2023-07-01-preview został wycofany 8 kwietnia 2024 r. i nie jest już obsługiwany od 8 lipca 2024 r. Ta wersja była pierwszym interfejsem API REST, który oferował obsługę wyszukiwania wektorów. Nowsze wersje interfejsu API mają inną konfigurację wektorów. Przeprowadź migrację do nowszej wersji interfejsu API lub nowszej wersji zestawu SDK tak szybko, jak to możliwe.

Wycofane wersje

Od 15 października 2020 r. następujące wersje interfejsu API nie są już udokumentowane ani obsługiwane:

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

Wszystkie zestawy SDK są oparte na wersjach interfejsu API REST. Jeśli wersja REST API zostanie wycofana, pakiety SDK oparte na tej wersji również zostaną wycofane. Wszystkie zestawy SDK Wyszukiwanie AI platformy Azure .NET starsze niż 3.0.0-rc są teraz przestarzałe.

Jeśli masz kod, który używa wycofanej wersji, przeprowadź migrację do nowszej wersji interfejsu API lub do nowszej wersji zestawu SDK.

Interfejsy REST API

interfejs API REST	Link
Usługa wyszukiwania (płaszczyzna danych)	Zobacz Wersje interfejsu API w dokumentacji interfejsu API REST.
Zarządzanie wyszukiwaniem (płaszczyzna kontrolna)	Zobacz Wersje interfejsu API w dokumentacji interfejsu API REST.

Azure SDK dla .NET

Wersja zestawu SDK	Stan	Dziennik zmian	opis
Azure. Search.Documents 12	Aktywne	Changelog	API dla operacji warstwy danych w usłudze, takich jak operacje odczytu i zapisu na zawartości i obiektach.
Azure. ResourceManager.Search	Aktywne	Changelog	Interfejsy API dla operacji płaszczyzny sterowania w usłudze wyszukiwania.

Azure SDK dla Java

Wersja zestawu SDK	Stan	Dziennik zmian	opis
azure-search-documents 12	Aktywne	Changelog	Użyj biblioteki klienta do operacji na warstwie danych.
azure-resourcemanager-search 2	Aktywne	Changelog	Użyj biblioteki klienta azure-resourcemanager-search do operacji płaszczyzny kontrolnej.

Azure SDK dla języka JavaScript

Wersja zestawu SDK	Stan	Dziennik zmian	opis
@azure/search-documents 13	Aktywne	Changelog	Użyj biblioteki klienta do operacji na warstwie danych.
@azure/arm-search 4	Aktywne	Changelog	Użyj pakietu @azure/arm-search do operacji płaszczyzny kontrolnej.

Azure SDK dla Python

Wersja zestawu SDK	Stan	Dziennik zmian	opis
azure-search-documents 12	Aktywne	Changelog	Użyj biblioteki klienta do operacji na warstwie danych.
azure-mgmt-search 9	Aktywne	Changelog	Użyj biblioteki klienta azure-mgmt-search do operacji płaszczyzny kontrolnej.

Wszystkie Azure SDKs

Jeśli szukasz bibliotek klienckich i dokumentacji beta, strona zawiera linki do wszystkich pakietów biblioteki Azure SDK, kodu i dokumentacji.