REST API-versioner (Azure AI Search)

Artikel
04/24/2024

I den här artikeln visas de aktuella och tidigare versionerna av Search REST API:er för Azure AI-Search.

Dokumentation om versions-API:et

REST API-dokument är nu versionshanterade. När du öppnar en API-referenssida visas en versionsväljare ovanför innehållsförteckningen.

Expandera referensdataplanet>.
Välj en API-referenssida.
Välj en API-version från listrutefiltret längst upp till vänster.

Stabila versioner

API-version	Specifikation	API-uppdateringar
`2023-11-01` (Senaste)	Swagger-specifikation	Versionsanteckning
`2020-06-30`	Swagger-specifikation	Versionsanteckning
`2019-05-06`	Swagger-specifikation	Lägger till komplexa typer.
`2017-11-11`	Swagger-specifikation	Lägger till kompetensuppsättningar och AI-berikande.
`2016-09-01`	Swagger-specifikation	Lägger till indexerare.
`2015-02-28`	Stöds inte efter 10-10-2020	Första allmänt tillgängliga versionen.

Förhandsversioner

Förhandsversioner släpps för att testa nya funktioner, samla in feedback och identifiera och åtgärda problem. Förhandsversions-API:er är tillgängliga under Kompletterande användningsvillkor för Förhandsversioner av Microsoft Azure.

API-version	Specifikation	API-uppdateringar
`2024-03-01-Preview` (Senaste)	Swagger-specifikation	Versionsanteckning
`2023-10-01-Preview`	Swagger-specifikation	Versionsanteckning
`2023-07-01-Preview` (inaktuell)	Swagger-specifikation	Versionsanteckning
`2021-04-30-Preview`	Swagger-specifikation	Versionsanteckning
`2020-06-30-Preview`	Swagger-specifikation	Versionsanteckning
`2019-05-06-Preview`	Swagger-specifikation	Versionsanteckning
`2017-11-11-Preview`	Swagger-specifikation	Förhandsversion som är associerad med en stabil version.
`2016-09-01-Preview`	Swagger-specifikation	Förhandsversion som är associerad med en stabil version.
`2015-02-28-Preview` (tillbakadragen)	Stöds inte efter 10-10-2020	Förhandsversion som är associerad med en stabil version.
`2014-10-20-Preview` (tillbakadragen)	Stöds inte efter 10-10-2020	Andra offentliga förhandsversionen.
`2014-07-31-Preview` (tillbakadragen)	Stöds inte efter 10-10-2020	Första offentliga förhandsversionen.

Viktig information

2024-03-01-Preview

Den här förhandsversionen bygger på 2023-10-01-preview genom att lägga till följande förhandsversions-API:er som hjälper dig att spara utrymme:

Nya smala datatyper för vektorfält om du har inbäddningsmodeller som stöder dem eller kvantiseringslogik som matar ut mindre vektorer.
Nya egenskaper för vektorkvantisering för inbyggd vektorkomprimering i ett sökindex.
Ny boolesk lagrad egenskap i ett vektorfält som avgör om en extra kopia av fältet lagras. Den extra kopian är det hämtningsbara innehållet i fältet. Om du inte lagrar det används fältet fortfarande i frågor, men kan inte returneras i ett sökresultat. Du kan ange att den här egenskapen ska spara utrymme på söktjänsten eller vektorkvoten i ett sökindex.

2023-11-01

Den här versionen innehåller allmänt tillgängliga funktioner, inklusive:

Semantisk rangordning i Search Post-begäranden.
Indexering av vektorsökning i Skapa- eller uppdateringsindexbegäranden och vektorfrågor i Search Publicera begäranden.

2023-10-01-Preview

Den här versionen innehåller alla funktioner som introducerades i tidigare förhandsversioner, samt tillägg och ändringar av API:er för vektorsökning. Uppdateringar till API:erna för vektorsökning är en icke-bakåtkompatibel ändring från 2023-07-01-Preview. Se Lägga till vektorfält och Skapa en vektorfråga för migreringshjälp.

Om du planerar att använda den nya förfilterfunktionen måste du använda ett index som skapats efter 2023-10-01.

Skapa eller uppdateringsindex:

vectorSearch har definitioner för algorithms, profilesoch vectorizers:
- algorithms fortsätter att stödja hnsw och stöder eknnnu även , med hänvisning till Hierarkisk navigerbar liten värld (HNSW) och uttömmande K-närmaste grannar (eKNN). I algoritmavsnittet kan du definiera flera namngivna kombinationer av HNSW- och eKNN-parametrar. Detta ersätter algorithmConfigurations i vectorSearch egenskapen i 2023-07-01-Preview.
- profiles är en ny definition som anger algoritmkonfigurationen. Anta till exempel att du har algoritmkonfigurationer med namnet HNSW-1, HSNW-2, eKNN-1. En profil kan ange HNSW-1.
- vectorizers definieras i ett index men används vid frågetillfället för att bädda in en textfrågesträng. En vektoriserare refererar till en inbäddningsmodell. Söktjänsten anropar inbäddningsmodellen för att vektorisera textfrågesträngen och skickar sedan resultatet till sökmotorn för en vektorfråga.
I vektorfält vectorSearchProfile ersätter vectorSearchConfiguration. Egenskapen vectorSearchProfile anger vilken vektorsökningsprofil som ska användas i fältet.
När du anropar API:et 2023-10-01-Preview som skapats före den här API-versionen måste du i din begäran ändra fältet för att ange ett vectorSearchProfile så länge profilen anger exakt samma algoritm som tidigare angavs i vectorSearchConfiguration. Om den befintliga fältdefinitionen till exempel anger "vectorSearchConfiguration": "myHnsw"måste du ersätta den med "vectorSearchProfile": "your profile name"och profilen måste definieras för att referera till samma "algorithm": "myHnsw".

Search dokument:

vectorQueriesvectors ersätter i 2023-07-01-Preview
vectorQueries.vectors ersätter vectors.values i 2023-07-01-Preview.
Vektorfrågan är nu en polymorfisk struktur. kind måste anges för att ange vilken typ av vektorfråga som begärs.
- "kind": "vector" innebär att frågan är en vektor, så anroparen bör redan ha vektoriserat sökfrågesträngen till en vektorinbäddning.
"exhaustive": "true" är en ny egenskap anger om du vill göra en fullständig (brute-force) k-närmaste grannsökning över alla vektorer i vektorindexet.
vectorFilterMode är en ny parameter för att ange förfiltrering (standard för index som skapats efter 2023-10-01) eller postfiltering (standard för tidigare index) i frågan.

2023-07-01-Preview

Viktigt

Utfasningen av förhandsversionen tillkännagavs den 15 april 2024 och kommer att dras tillbaka den 8 juli 2024. Hjälp med migrering finns i Uppgradera REST-API:er i Azure AI-Search.

Den här versionen har funktioner från tidigare förhandsversioner, plus stöd för vektorsökning:

I sökindexet tilldelar du Collection(Edm.Single) datatyp för fält som innehåller en matris med flyttal med enkel precision. Det här är datatypen för den nya vektorsökningsfunktionen som används för att lagra en genererad inbäddning per dokumentfält. Ange även egenskaper för vektorkonfiguration i sökindexet. Se Skapa eller Uppdateringsindex för dessa API:er.
Indexeringsarbetsbelastningar uppdateras för att acceptera vektordata. Se Lägga till, uppdatera eller ta bort dokument.
Frågeparametrar för vektorsökning. Se Search Dokument för dessa parametrar.
Hämta tjänststatistik: returnerar vektorindexkvot och användning för tjänsten.
Hämta indexstatistik: returnerar vektorindexkvot och användning för sökindexet.

2021-04-30-Preview

Den här förhandsversionen innehåller alla funktioner som introducerades i 2020-06-30-Preview, plus tillägg till följande API:er:

Indexalias lägger till ett sekundärt namn som används för att referera till index i fråge- och indexeringsbegäranden. Aliasåtgärder inkluderar skapa, uppdatera, ta bort, hämta och lista.
Hanterade identiteter för utgående anslutningar. Nya värden för anslutningssträngar i Skapa eller Uppdatera datakälla stöder anslutningar med Microsoft Entra ID autentisering och roller i stället för hårdkodade databasautentiseringsuppgifter eller nycklar.
Stöd för hanterad identitet stöds också för key vault-anslutningar, för söklösningar som kompletterar standardkryptering med kundhanterad kryptering.
Fler språk för den kognitiva färdigheten för textöversättning.
Fler queryLanguages för semantisk sökning och stavning i Search Dokument (förhandsversion).
En undertextparameter för att begära undertexter från semantisk sökning i Search Dokument (förhandsversion).
Semantiska konfigurationer anges i Skapa eller uppdateringsindex. En semantisk konfiguration avgör vilka fält som ska användas för semantisk rangordning, undertexter, höjdpunkter och svar.
En semanticConfiguration-parameter som krävs för semantiska frågor i Search Dokument (förhandsversion).

2020-06-30