Verze rozhraní REST API (Azure AI Search)

Článek
04/24/2024

Tento článek obsahuje seznam aktuálních a minulých verzí rozhraní REST API Search pro azure AI Search.

Dokumentace k rozhraní API s verzemi

Dokumentace k rozhraní REST API je teď ve verzích. Když otevřete stránku s referenčními informacemi k rozhraní API, zobrazí se nad obsahem selektor verzí.

Rozbalte referenční > rovinu dat.
Vyberte stránku s referenčními informacemi k rozhraní API.
V rozevíracím filtru vlevo nahoře zvolte verzi rozhraní API .

Stabilní verze

Verze rozhraní API	Specifikace	Aktualizace rozhraní API
`2023-11-01` (Nejnovější)	Specifikace Swaggeru	Poznámky k verzi
`2020-06-30`	Specifikace Swaggeru	Poznámky k verzi
`2019-05-06`	Specifikace Swaggeru	Přidá komplexní typy.
`2017-11-11`	Specifikace Swaggeru	Přidává sady dovedností a rozšiřování AI.
`2016-09-01`	Specifikace Swaggeru	Přidá indexery.
`2015-02-28`	Nepodporováno po 10. 10. 2020	První obecně dostupná verze.

Verze Preview

Verze Preview jsou vydávány za účelem testování nových funkcí, získávání zpětné vazby a zjišťování a řešení problémů. Rozhraní API verze Preview jsou k dispozici v rámci doplňkových podmínek použití pro verze Microsoft Azure Preview.

Verze rozhraní API	Specifikace	Aktualizace rozhraní API
`2024-03-01-Preview` (Nejnovější)	Specifikace Swaggeru	Poznámky k verzi
`2023-10-01-Preview`	Specifikace Swaggeru	Poznámky k verzi
`2023-07-01-Preview` (zastaralé)	Specifikace Swaggeru	Poznámky k verzi
`2021-04-30-Preview`	Specifikace Swaggeru	Poznámky k verzi
`2020-06-30-Preview`	Specifikace Swaggeru	Poznámky k verzi
`2019-05-06-Preview`	Specifikace Swaggeru	Poznámky k verzi
`2017-11-11-Preview`	Specifikace Swaggeru	Verze Preview přidružená ke stabilní verzi
`2016-09-01-Preview`	Specifikace Swaggeru	Verze Preview přidružená ke stabilní verzi
`2015-02-28-Preview` (vyřazeno)	Nepodporováno po 10. 10. 2020	Verze Preview přidružená ke stabilní verzi
`2014-10-20-Preview` (vyřazeno)	Nepodporováno po 10. 10. 2020	Druhá verze Public Preview.
`2014-07-31-Preview` (vyřazeno)	Nepodporováno po 10. 10. 2020	První verze Public Preview.

Poznámky k verzi

2024-03-01-Preview

Tato verze Preview je založená na 2023-10-01-preview přidání následujících rozhraní API preview, která vám pomůžou šetřit místo:

Nové úzké datové typy pro vektorová pole , pokud máte modely vkládání, které je podporují, nebo logiku kvantování, která vypisuje menší vektory.
Nové vlastnosti kvantování vektorů pro integrovanou kompresi vektorů ve vyhledávacím indexu.
Nová logická vlastnost uložená u vektorového pole , která určuje, zda je uložena další kopie pole. Další kopie je obsah tohoto pole, který lze získat. Pokud ho neukládáte, pole se stále používá v dotazech, ale nelze ho vrátit ve výsledcích hledání. Tuto vlastnost můžete nastavit tak, aby se šetřilo místo ve vyhledávací službě nebo kvótě vektorů ve vyhledávacím indexu.

2023-11-01

Tato verze poskytuje obecně dostupné funkce, mezi které patří:

Sémantické řazení v žádostech Search Post.
Indexování vektorových vyhledávání v požadavcích Create nebo Update Index a vektorové dotazy v požadavcích Search Post.

2023-10-01-Preview

Tato verze obsahuje všechny funkce představené v předchozích verzích Preview a navíc doplňky a úpravy rozhraní API pro vektorové vyhledávání. Aktualizace rozhraní API pro vektorové vyhledávání představují zásadní změnu z verze 2023-07-01-Preview. Nápovědu k migraci najdete v tématu Přidání vektorových polí a Create vektorového dotazu.

Pokud plánujete používat novou funkci předfiltrování, musíte použít index vytvořený po 1. 10. 2023.

Create nebo index aktualizací:

vectorSearch obsahuje definice pro algorithms, profilesa vectorizers:
- algorithms i nadále podporuje hnsw a nyní také podporuje eknn, s odkazem na Hierarchical Navigable Small World (HNSW) a vyčerpávající K-nejbližší sousedy (eKNN). V části algoritmu můžete definovat více pojmenovaných kombinací parametrů HNSW a eKNN. algorithmConfigurations Nahradí se v rámci vectorSearch vlastnosti ve verzi 2023-07-01-Preview.
- profiles je nová definice, která určuje konfiguraci algoritmu. Předpokládejme například, že máte konfigurace algoritmů s názvy HNSW-1, HSNW-2, eKNN-1. Profil může určovat HNSW-1.
- vectorizers je definován v indexu, ale používá se v době dotazu k vložení textového řetězce dotazu. Vektorizátor odkazuje na vložený model. Vyhledávací služba zavolá model vložení, aby vektorizoval řetězec textového dotazu, a pak předá výsledek do vyhledávacího webu pro vektorový dotaz.
U vektorových polí vectorSearchProfile nahradí vectorSearchConfiguration. Vlastnost vectorSearchProfile určuje, který profil vektorového vyhledávání se má v poli použít.
U indexů vytvořených před touto verzí rozhraní API musíte při volání rozhraní API 2023-10-01-Preview ve vaší žádosti změnit pole tak, aby bylo zadáno vectorSearchProfile , pokud profil určuje přesně stejný algoritmus, který byl dříve zadán v vectorSearchConfigurationnástroji . Pokud například existující definice pole určuje "vectorSearchConfiguration": "myHnsw", musíte ho nahradit parametrem "vectorSearchProfile": "your profile name"a profil musí být definován tak, aby odkaz na stejný "algorithm": "myHnsw".

Search dokumenty:

vectorQueriesvectors nahrazuje ve verzi 2023-07-01-Preview
vectorQueries.vectorsvectors.values nahradí ve verzi 2023-07-01-Preview.
Vektorový dotaz je nyní polymorfní struktura. kind musí být zadán k označení typu vektorového dotazu, který se požaduje.
- "kind": "vector" znamená, že dotaz je vektor, takže volající by již měl vektorizovat řetězec vyhledávacího dotazu na vložení vektoru.
"exhaustive": "true" je nová vlastnost určuje, jestli se má provést vyčerpávající (hrubou silou) hledání k-nejbližších sousedů napříč všemi vektory v rámci indexu vektoru.
vectorFilterMode je nový parametr pro určení předběžného filtrování (výchozí nastavení pro indexy vytvořené po 1. 10. 2023) nebo postfiltering (výchozí u předchozích indexů) v dotazu.

2023-07-01-Preview

Důležité

Vyřazení této verze Preview bylo oznámeno 15. dubna 2024 a vyřazeno bude 8. července 2024. Nápovědu k migraci najdete v tématu Upgrade rozhraní REST API v Azure AI Search.

Tato verze obsahuje funkce z předchozích verzí Preview a navíc podporuje vektorové vyhledávání:

V indexu vyhledávání přiřaďte Collection(Edm.Single) datový typ polím, která obsahují pole čísel s plovoucí desetinou čárkou s jednoduchou přesností. Toto je datový typ pro novou funkci vektorového vyhledávání, která se používá k uložení jednoho vygenerovaného pole vložení pro každý dokument. V indexu vyhledávání také zadejte vlastnosti konfigurace vektoru. Projděte si Create nebo aktualizovat index pro tato rozhraní API.
Úlohy indexování se aktualizují tak, aby přijímaly vektorová data. Viz Přidání, aktualizace nebo odstranění dokumentů.
Parametry dotazu pro vektorové vyhledávání. Tyto parametry najdete v dokumentu Search.
Získat statistiku služby: Vrátí kvótu a využití vektorových indexů pro službu.
Získat statistiku indexu: Vrátí kvótu vektorového indexu a využití indexu vyhledávání.

2021-04-30-Preview

Tato verze Preview zahrnuje všechny funkce představené ve verzi 2020-06-30-Preview a navíc k následujícím rozhraním API:

Alias indexu přidá sekundární název, který se používá pro odkazování na indexy v dotazech a indexování požadavků. Operace aliasů zahrnují vytvoření, aktualizaci, odstranění, získání a výpis.
Spravované identity pro odchozí připojení Nové hodnoty připojovacích řetězců v Create nebo Aktualizovat zdroj dat podporují připojení pomocí Microsoft Entra ID ověřování a rolí místo pevně zakódovaných přihlašovacích údajů nebo klíčů k databázi.
Podpora spravovaných identit se podporuje také pro připojení trezoru klíčů a pro vyhledávací řešení, která doplňují výchozí šifrování o šifrování spravované zákazníkem.
Další jazyky pro kognitivní dovednost překladu textu
Další dotazyJazyky pro sémantické vyhledávání a kontrolu pravopisu v dokumentech Search (Preview)
Parametr captions, který volitelně požaduje titulky ze sémantického vyhledávání v Search Documents (Preview)
Sémantické konfigurace se zadává v Create nebo Aktualizovat index. Sémantická konfigurace určuje, která pole se mají použít pro sémantické řazení, titulky, zvýraznění a odpovědi.
Parametr sémanticConfiguration, který se vyžaduje pro sémantické dotazy v Search Documents (Preview).

2020-06-30