Wersje interfejsu API REST (Azure AI Search)

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

Dokumentacja wersji interfejsu API

Dokumentacja interfejsu API REST jest teraz wersjonowana. Po otwarciu strony dokumentacji interfejsu API nad spisem treści pojawi się selektor wersji. Upewnij się, że dokumentacja interfejsu API pochodzi z folderu Reference>Data Plane.

Stabilne wersje

Wersje wersji zapoznawczej

Wersje zapoznawcza 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 uzupełniających warunków użytkowania dla wersji zapoznawczych platformy Microsoft Azure.

Wersji

2024-07-01

Ta wersja zapewnia ogólnie dostępne aktualizacje zintegrowanej wektoryzacji (umiejętności i wektoryzatorów), kwantyzacji skalarnych i kwantyzacji binarnej. Aby uzyskać szczegółowe informacje, zobacz Co nowego w usłudze Azure AI Search.

2024-05-01-preview

Ta wersja zapoznawcza dodaje obsługę indeksowania usługi OneLake, dostrajania istotności i dokładniejszej integracji z bardziej osadzanymi modelami podczas indeksowania i zapytań. Opiera się on na 2024-03-01-preview, dlatego ma również kwantyzację skalarną, wąskie typy danych i opcje magazynu wprowadzone w tej wersji.

Aby przeprowadzić uaktualnienie z 2024-03-01-preview lub 2023-10-01-preview, zaktualizuj umiejętności azureOpenAIEmbedding lub wektoryzatora, aby uwzględnić nazwę i wymiary modelu. Aby uaktualnić z 2023-07-01-preview (przestarzałe) lub instrukcje krok po kroku, zobacz Uaktualnianie interfejsów API REST.

Poniżej przedstawiono aktualizacje w tej wersji zapoznawczej. Zalecamy również Co nowego w usłudze Azure AI Search.

2024-03-01-preview

Ta wersja zapoznawcza jest oparta na 2023-10-01-preview przez dodanie interfejsów API w wersji zapoznawczej zwiększających magazyn wektorów. Aby uzyskać szczegółowe informacje, zobacz Co nowego w usłudze Azure AI Search.

2023-11-01

Ta wersja udostępnia ogólnie dostępne funkcje. Aby uzyskać szczegółowe informacje, zobacz Co nowego w usłudze Azure AI Search.

2023-10-01-preview

Ta wersja zawiera wszystkie funkcje wprowadzone w poprzednich wersjach zapoznawczych oraz dodatki i modyfikacje interfejsów API wyszukiwania wektorowego. Aktualizacje 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 Tworzenie zapytania wektorowego.

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

tworzenie lub aktualizowanieindeksu:

• vectorSearch zawiera definicje algorithms, profilesi vectorizers:

  • algorithms nadal obsługuje hnsw, a teraz obsługuje również eknn, w odniesieniu do hierarchicznego nawigowalnego małego świata (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 we 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ć HNSW-1.

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

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

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

przeszukiwanie dokumentów:

• vectorQueries zastępuje vectors w wersji 2023-07-01-Preview
• vectorQueries.vectors zastępuje vectors.values 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 wektorowego osadzania.
• "exhaustive": "true" jest nową właściwością określa, czy wykonać wyczerpujące (siłowe) k najbliższego sąsiada wyszukiwania we wszystkich wektorach w indeksie wektorów.
• vectorFilterMode to nowy parametr służący do określania wstępnego filtrowania (domyślnego dla indeksów utworzonych po 2023-10-01) lub pofiltrowaniu (domyślnie w poprzednich indeksach) w zapytaniu.

Od 29 marca 2024 r. odpowiedzi GET nie zwracają już parametrów połączenia ani kluczy. Aby uzyskać szczegółowe informacje, zobacz Zmiana powodująca niezgodność kodu klienta, który odczytuje informacje o połączeniu.

2023-07-01-preview

Ta wersja wprowadziła obsługę wektorów i używa konfiguracji wektorów, która jest niezgodna z nowszymi wersjami interfejsu API.

• Dodano Collection(Edm.Single) typ danych w polach, które zawierają tablicę liczb zmiennoprzecinkowych o pojedynczej precyzji. Jest to typ danych dla wektorów używany do przechowywania jednego wygenerowanego osadzania dla pola dokumentu. Indeks wyszukiwania określa również właściwości konfiguracji wektora. Zobacz Tworzenie lub aktualizowanie indeksu dla tych interfejsów API.
• Zaktualizowano obciążenia indeksowania w celu akceptowania danych wektorowych. Zobacz Dodawanie, aktualizowanie lub usuwanie dokumentów.
• Dodano parametry zapytania do wyszukiwania wektorowego. Aby uzyskać te parametry, zobacz Search Documents (Dokumenty wyszukiwania).
• Get Service Statistics: zwraca limit przydziału indeksu wektora i użycie dla usługi.
• Pobierz statystyki indeksu: zwraca limit przydziału indeksu wektorowego i użycie dla indeksu wyszukiwania.
• Od 29 marca 2024 r. odpowiedzi GET nie zwracają już parametrów połączenia ani kluczy. Aby uzyskać szczegółowe informacje, zobacz Zmiana powodująca niezgodność kodu klienta, który odczytuje informacje o połączeniu.

2021-04-30-preview

Ta wersja zapoznawcza zawiera wszystkie funkcje wprowadzone w wersji zapoznawczej 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 Tworzenie lub aktualizowanie źródła danych obsługują połączenia przy użyciu uwierzytelniania i ról identyfikatora Entra firmy Microsoft zamiast zakodowanych na podstawie poświadczeń lub kluczy bazy danych.
• 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 za pomocą szyfrowania zarządzanego przez klienta.
• Więcej języków umiejętności poznawczych tłumaczenia tekstu.
• Więcej zapytańLanguage dla semantycznego wyszukiwania i sprawdzania pisowni w search documents (wersja zapoznawcza).
• Parametr captions do opcjonalnego żądania podpisów z wyszukiwania semantycznego w Search Documents (wersja zapoznawcza).
• konfiguracje semantyczne są określone w tworzenie lub aktualizowanie indeksu. Semantyczna konfiguracja określa, które pola powinny być używane do semantycznego klasyfikowania, podpisów, wyróżnień i odpowiedzi.
• SemanticConfiguration parametr wymagany do semantycznych zapytań w Search Documents (wersja zapoznawcza).
• Od 29 marca 2024 r. odpowiedzi GET nie zwracają już parametrów połączenia ani kluczy. Aby uzyskać szczegółowe informacje, zobacz Zmiana powodująca niezgodność kodu klienta, który odczytuje informacje o połączeniu.

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
• Umiejętność wyszukiwania jednostek niestandardowych
• Indeksatory działające w ramach tożsamości systemowej lub zarządzanej przez użytkownika za pośrednictwem identyfikatora Entra firmy Microsoft
• Od 29 marca 2024 r. odpowiedzi GET nie zwracają już parametrów połączenia ani kluczy. Aby uzyskać szczegółowe informacje, zobacz Zmiana powodująca niezgodność kodu klienta, który odczytuje informacje o połączeniu.

2020-06-30-preview

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

• Wyszukiwanie semantyczne, funkcja premium uruchamiana w usługach warstwy Standardowa i wywołująca klasyfikację semantyczną.
• Źródło danych indeksatora dla łączników dodatku Power Query
• Źródło danych indeksatora dla programu 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ść Normalizer dla normalizacji 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ść poznawcza rozpoznawania jednostek (wersja 3)
• Umiejętność poznawcza analizy tonacji (wersja 3)
• Od 29 marca 2024 r. odpowiedzi GET nie zwracają już parametrów połączenia ani kluczy. Aby uzyskać szczegółowe informacje, zobacz Zmiana powodująca niezgodność kodu klienta, który odczytuje informacje o połączeniu.

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 do usuwania nietrwałego 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ść poznawcza wykrywania identyfikacji osobistej
• Buforowanie wzbogaconych dokumentów w celu zachowania i ponownego użycia przetwarzania obrazów (oraz innych wzbogacenia sztucznej inteligencji)
• Od 29 marca 2024 r. odpowiedzi GET nie zwracają już parametrów połączenia ani kluczy. Aby uzyskać szczegółowe informacje, zobacz Zmiana powodująca niezgodność kodu klienta, który odczytuje informacje o połączeniu.

Zobacz też

• Tworzenie usługi wyszukiwania
• Szybki start: tworzenie indeksu usługi Azure AI Search przy użyciu interfejsów API REST