Wersje interfejsu API REST (azure AI Search)

W tym artykule wymieniono bieżące i wcześniejsze wersje interfejsów API REST Search dla usługi Azure AI Search.

Dokumentacja wersji interfejsu API

Dokumentacja interfejsu API REST jest teraz w wersji. Po otwarciu strony referencyjnej interfejsu API selektor wersji pojawi się nad spisem treści.

1. Rozwiń węzeł Płaszczyzna danych referencyjnych>.

2. Wybierz stronę referencyjną interfejsu API.

3. Wybierz wersję interfejsu API z filtru rozwijanego w lewym górnym rogu.

   

Stabilne wersje

Wersja interfejsu API	Specyfikacja	Aktualizacje interfejsu API
2023-11-01 (Najnowsze)	Specyfikacja struktury Swagger	Informacja o wersji
2020-06-30	Specyfikacja struktury Swagger	Informacja o wersji
2019-05-06	Specyfikacja struktury Swagger	Dodaje typy złożone.
2017-11-11	Specyfikacja struktury Swagger	Dodaje zestawy umiejętności i wzbogacanie sztucznej inteligencji.
2016-09-01	Specyfikacja struktury Swagger	Dodaje indeksatory.
2015-02-28	Nieobsługiwane po 10-10-2020	Pierwsza ogólnie dostępna wersja.

Wersje wersji zapoznawczej

Wersje wersji zapoznawczej są wydawane w celu testowania nowych funkcji, zbierania opinii i odnajdywania i rozwiązywania problemów. Interfejsy API w wersji zapoznawczej są dostępne w obszarze Dodatkowe warunki użytkowania dla wersji zapoznawczej platformy Microsoft Azure.

Wersja interfejsu API	Specyfikacja	Aktualizacje interfejsu API
2024-03-01-Preview (Najnowsze)	Specyfikacja struktury Swagger	Informacja o wersji
2023-10-01-Preview	Specyfikacja struktury Swagger	Informacja o wersji
2023-07-01-Preview (przestarzałe)	Specyfikacja struktury Swagger	Informacja o wersji
2021-04-30-Preview	Specyfikacja struktury Swagger	Informacja o wersji
2020-06-30-Preview	Specyfikacja struktury Swagger	Informacja o wersji
2019-05-06-Preview	Specyfikacja struktury Swagger	Informacja o wersji
2017-11-11-Preview	Specyfikacja struktury Swagger	Wersja zapoznawcza skojarzona ze stabilną wersją.
2016-09-01-Preview	Specyfikacja struktury Swagger	Wersja zapoznawcza skojarzona ze stabilną wersją.
2015-02-28-Preview (wycofano)	Nieobsługiwane po 10-10-2020	Wersja zapoznawcza skojarzona ze stabilną wersją.
2014-10-20-Preview (wycofano)	Nieobsługiwane po 10-10-2020	Druga publiczna wersja zapoznawcza.
2014-07-31-Preview (wycofano)	Nieobsługiwane po 10-10-2020	Pierwsza publiczna wersja zapoznawcza.

Informacje o wersji

2024-03-01-Preview

Ta wersja zapoznawcza jest oparta na 2023-10-01-preview dodawaniu następujących interfejsów API w wersji zapoznawczej, które pomagają zaoszczędzić miejsce:

• Nowe wąskie typy danych dla pól wektorów , jeśli zostały osadzone modele, które obsługują je lub logikę kwantyzacji, która generuje mniejsze wektory.
• Nowe właściwości kwantyzacji wektorów wbudowanych w indeksie wyszukiwania.
• Nowa właściwość logiczna przechowywana w polu wektorowym , która określa, czy jest przechowywana dodatkowa kopia pola. Dodatkowa kopia jest pobieraną zawartością tego pola. Jeśli go nie przechowujesz, pole jest nadal używane w zapytaniach, ale nie można ich zwrócić w wynikach wyszukiwania. Tę właściwość można ustawić, aby zaoszczędzić miejsce w usłudze wyszukiwania lub limit przydziału wektorów w indeksie wyszukiwania.

2023-11-01

Ta wersja udostępnia ogólnie dostępne funkcje, w tym:

• Klasyfikacja semantyczna w Search Żądania postów.
• Indeksowanie wyszukiwania wektorowego w żądaniach Twórca lub aktualizacji indeksu oraz zapytania wektorowe w żądaniach Search Post.

2023-10-01-Preview

Ta wersja zawiera wszystkie funkcje wprowadzone w poprzednich wersjach zapoznawczych oraz dodatki i modyfikacje interfejsów API wyszukiwania wektorowego. Aktualizacje do interfejsów API wyszukiwania wektorowego to zmiana powodująca niezgodność z wersji 2023-07-01-Preview. Aby uzyskać pomoc dotyczącą migracji, zobacz Dodawanie pól wektorów i Twórca zapytania wektorowego.

Jeśli planujesz użyć nowej funkcji filtrowania wstępnego, musisz użyć indeksu utworzonego po 2023-10-01.

Twórca lub aktualizuj indeks:

• vectorSearchzawiera definicje , algorithmsprofilesi vectorizers:

  • algorithms nadal obsługuje hnsw usługę , a teraz obsługuje eknnrównież usługę , w odniesieniu do hierarchicznego środowiska nawigacji dla małych światów (HNSW) i wyczerpujących najbliższych sąsiadów (eKNN). W sekcji algorytmu można zdefiniować wiele nazwanych kombinacji parametrów HNSW i eKNN. Spowoduje to zastąpienie algorithmConfigurations właściwości vectorSearch w wersji 2023-07-01-Preview.

  • profiles to nowa definicja określająca konfigurację algorytmu. Załóżmy na przykład, że masz konfiguracje algorytmów o nazwie HNSW-1, HSNW-2, eKNN-1. Profil może określać wartość HNSW-1.

  • vectorizers jest definiowany w indeksie, ale używany w czasie zapytania do osadzania ciągu zapytania tekstowego. Wektoryzator odwołuje się do modelu osadzania. Usługa wyszukiwania wykonuje wywołanie modelu osadzania w celu wektoryzacji ciągu zapytania tekstowego, a następnie przekazuje wynik do aparatu wyszukiwania dla zapytania wektorowego.

• W polach vectorSearchProfile wektorów vectorSearchConfigurationzastępuje element . Właściwość vectorSearchProfile określa, który profil wyszukiwania wektorów ma być używany w polu.

• W indeksach utworzonych przed tą wersją vectorSearchProfile interfejsu API po wywołaniu interfejsu API 2023-10-01-Preview w żądaniu należy zmienić pole, aby określić tak długo, jak profil określa dokładnie ten sam algorytm wcześniej określony w vectorSearchConfigurationelemecie . Jeśli na przykład istniejąca definicja pola określa "vectorSearchConfiguration": "myHnsw"wartość , należy zastąpić ją elementem "vectorSearchProfile": "your profile name", a profil musi być zdefiniowany w celu odwołania się do tego samego "algorithm": "myHnsw"elementu .

Search Dokumenty:

• vectorQueriesvectors zastępuje w wersji 2023-07-01-Preview

• vectorQueries.vectorsvectors.values zastępuje w wersji 2023-07-01-Preview.

• Zapytanie wektorowe jest teraz strukturą polimorficzną. kind należy określić, aby określić typ żądanego zapytania wektorowego.

  • "kind": "vector" oznacza, że zapytanie jest wektorem, więc obiekt wywołujący powinien już wektoryzować ciąg zapytania wyszukiwania do osadzania wektorowego.

• "exhaustive": "true" to nowa właściwość określa, czy należy wykonać wyczerpujące (siłowe) k najbliższego sąsiada wyszukiwania we wszystkich wektorach w indeksie wektorów.

• vectorFilterMode jest nowym parametrem służącym do określania wstępnego filtrowania (domyślnego dla indeksów utworzonych po 2023-10-01) lub filtrowania postfiltrującego (domyślnego dla poprzednich indeksów) w zapytaniu.

2023-07-01-Preview

Ważne

Wycofanie tej wersji zapoznawczej zostało ogłoszone 15 kwietnia 2024 r. i zostanie wycofane 8 lipca 2024 r. Aby uzyskać pomoc dotyczącą migracji, zobacz Uaktualnianie interfejsów API REST w usłudze Azure AI Search.

Ta wersja ma funkcje z poprzednich wersji zapoznawczych oraz obsługę wyszukiwania wektorów:

• W indeksie wyszukiwania przypisz Collection(Edm.Single) typ danych w polach zawierających tablicę liczb zmiennoprzecinkowych o pojedynczej precyzji. Jest to typ danych dla nowej funkcji wyszukiwania wektorowego używanego do przechowywania jednego wygenerowanego osadzania dla pola dokumentu. Ponadto w indeksie wyszukiwania określ właściwości konfiguracji wektora. Zobacz Twórca lub Aktualizuj indeks dla tych interfejsów API.

• Obciążenia indeksowania są aktualizowane w celu akceptowania danych wektorowych. Zobacz Dodawanie, aktualizowanie lub usuwanie dokumentów.

• Parametry zapytania dla wyszukiwania wektorów. Zobacz Search Dokumenty, aby uzyskać te parametry.

• Pobieranie statystyk usługi: zwraca limit przydziału indeksu wektora i użycie dla usługi.

• Pobierz statystykę indeksu: zwraca limit przydziału indeksu wektorowego i użycie indeksu wyszukiwania.

2021-04-30-Preview

Ta wersja zapoznawcza obejmuje wszystkie funkcje wprowadzone w wersji 2020-06-30-Preview oraz dodatki do następujących interfejsów API:

• Alias indeksu dodaje nazwę pomocniczą używaną do odwoływania się do indeksów w żądaniach zapytań i indeksowania. Operacje aliasu obejmują tworzenie, aktualizowanie, usuwanie, pobieranie i wyświetlanie listy.

• Tożsamości zarządzane dla połączeń wychodzących. Nowe wartości parametrów połączenia w połączeniach Twórca lub Aktualizuj źródło danych obsługują połączenia przy użyciu uwierzytelniania i ról Tożsamość Microsoft Entra zamiast zakodowanych na podstawie twardych poświadczeń bazy danych lub kluczy.

• Obsługa tożsamości zarządzanej jest również obsługiwana w przypadku połączeń magazynu kluczy w przypadku rozwiązań wyszukiwania, które uzupełniają domyślne szyfrowanie przy użyciu szyfrowania zarządzanego przez klienta.

• Więcej języków umiejętności poznawczych tłumaczenia tekstu.

• Więcej zapytańLanguages dla semantycznego wyszukiwania i sprawdzania pisowni w dokumentach Search (wersja zapoznawcza).

• Parametr captions do opcjonalnego żądania podpisów z wyszukiwania semantycznego w Search Documents (wersja zapoznawcza).

• Konfiguracje semantyczne są określane w Twórca lub w indeksie aktualizacji. Semantyczna konfiguracja określa, które pola mają być używane do klasyfikacji semantycznej, podpisów, wyróżnień i odpowiedzi.

• SemanticConfiguration parametr wymagany dla zapytań semantycznych w Search Documents (wersja zapoznawcza).

2020-06-30

Ta wersja udostępnia ogólnie dostępne funkcje, w tym:

• Kontrola dostępu oparta na rolach platformy Azure na potrzeby operacji płaszczyzny danych
• Ocenianie istotności (BM25)
• Magazyny wiedzy
• Źródło danych indeksatora dla usługi Azure Data Lake Storage (ADLS) Gen2
• Niestandardowa umiejętność wyszukiwania jednostek
• Indeksatory działające w ramach tożsamości systemowej lub zarządzanej przez użytkownika za pośrednictwem Tożsamość Microsoft Entra

2020-06-30-Preview

Ta wersja zapoznawcza obejmuje wszystkie funkcje wprowadzone w wersji 2019-05-06-Preview oraz następujące dodatki:

• Wyszukiwanie semantyczne, funkcja premium działająca w usługach warstwy Standardowa i wywołująca klasyfikację semantyczną.
• Źródło danych indeksatora dla łączników Power Query
• Źródło danych indeksatora dla bazy danych MySQL
• Źródło danych indeksatora dla interfejsu API języka Gremlin usługi Cosmos DB
• Źródło danych indeksatora dla usługi SharePoint Online
• Właściwość normalizatora tekstu w przypadku filtrowania bez uwzględniania wielkości liter, tworzenia aspektów i sortowania
• Resetowanie dokumentów do indeksowania opartego na indeksatorze w celu specjalnie odświeżenia określonych dokumentów według identyfikatora
• Umiejętność poznawcza łączenia jednostek (wersja 3)
• Umiejętności poznawcze rozpoznawania jednostek (wersja 3)
• Umiejętności poznawcze analizy tonacji (wersja 3)

2019-05-06-Preview

• Obsługa źródła danych indeksatora dla interfejsu API bazy danych MongoDB usługi Cosmos DB
• Źródło danych indeksatora dla natywnego usuwania nietrwałego obiektu blob w usłudze Blob Storage
• featuresMode parametr, który zwraca szczegółowe informacje o wyniku istotności
• Umiejętności poznawcze usługi Azure Machine Learning (AML)
• Umiejętności poznawcze wykrywania identyfikacji osobistej
• Buforowanie wzbogaconych dokumentów w celu zachowania i ponownego użycia przetwarzania obrazów (i innych wzbogacenia sztucznej inteligencji)

Zobacz też

• Twórca usługi wyszukiwania
• Szybki start: Twórca indeks Search usługi Azure AI przy użyciu interfejsów API REST