Versioni dell'API REST (Search di Intelligenza artificiale di Azure)

Articolo
05/01/2024

Questo articolo elenca le versioni correnti e precedenti delle API REST Search per l'intelligenza artificiale di Azure Search.

Documentazione dell'API con controllo delle versioni

La documentazione dell'API REST è ora con controllo delle versioni. Quando si apre una pagina di riferimento api, un selettore di versione viene visualizzato sopra il sommario. Assicurarsi che il riferimento all'API provena dalla cartellaPiano datidi riferimento>.

Screenshot del selettore di versione.

Versioni stabili

Versione dell'API	Specifiche	Aggiornamenti delle API
`2023-11-01` (Più recente)	Specifica Swagger	Note sulla versione
`2020-06-30`	Specifica Swagger	Note sulla versione
`2019-05-06`	Specifica Swagger	Aggiunge tipi complessi.
`2017-11-11`	Specifica Swagger	Aggiunge set di competenze e arricchimento tramite intelligenza artificiale.
`2016-09-01`	Specifica Swagger	Aggiunge indicizzatori.
`2015-02-28`	Non supportato dopo il 10-10-2020	Prima versione disponibile a livello generale.

Versioni di anteprima

Le versioni di anteprima vengono rilasciate per testare nuove funzionalità, raccogliere commenti e suggerimenti e individuare e risolvere i problemi. Le API di anteprima sono disponibili in Condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure.

Versione dell'API	Specifiche	Aggiornamenti delle API
`2024-03-01-Preview` (Più recente)	Specifica Swagger	Note sulla versione
`2023-10-01-Preview`	Specifica Swagger	Note sulla versione
`2023-07-01-Preview` (deprecato)	Specifica Swagger	Note sulla versione
`2021-04-30-Preview`	Specifica Swagger	Note sulla versione
`2020-06-30-Preview`	Specifica Swagger	Note sulla versione
`2019-05-06-Preview`	Specifica Swagger	Note sulla versione
`2017-11-11-Preview`	Specifica Swagger	Versione di anteprima associata alla versione stabile.
`2016-09-01-Preview`	Specifica Swagger	Versione di anteprima associata alla versione stabile.
`2015-02-28-Preview` (ritirato)	Non supportato dopo il 10-10-2020	Versione di anteprima associata alla versione stabile.
`2014-10-20-Preview` (ritirato)	Non supportato dopo il 10-10-2020	Seconda anteprima pubblica.
`2014-07-31-Preview` (ritirato)	Non supportato dopo il 10-10-2020	Prima anteprima pubblica.

Note sulla versione

2024-03-01-Preview

Questa versione di anteprima si basa sull'aggiunta 2023-10-01-preview delle API di anteprima seguenti che consentono di risparmiare spazio:

Nuovi tipi di dati stretti per i campi vettoriali se sono stati incorporati modelli che li supportano o la logica di quantizzazione che restituisce vettori più piccoli.
Nuove proprietà di quantizzazione vettoriale per la compressione vettoriale predefinita in un indice di ricerca.
Nuova proprietà booleana archiviata in un campo vettoriale che determina se è archiviata una copia aggiuntiva del campo. La copia aggiuntiva è il contenuto recuperabile di tale campo. Se non lo si archivia, il campo viene ancora usato nelle query, ma non può essere restituito in un risultato di ricerca. È possibile impostare questa proprietà per risparmiare spazio nel servizio di ricerca o nella quota vettoriale in un indice di ricerca.
A partire dal 29 marzo 2024: le risposte GET non restituiscono più stringhe di connessione o chiavi. Per informazioni dettagliate , vedere Modifica di rilievo per il codice client che legge le informazioni di connessione .

2023-11-01

Questa versione offre funzionalità disponibili a livello generale, tra cui:

Classificazione semantica nelle richieste post di Search.
Indicizzazione vettoriale nelle richieste di Create o aggiorna indice e query vettoriali in Search richieste Post.
A partire dal 29 marzo 2024: le risposte GET non restituiscono più stringhe di connessione o chiavi. Per informazioni dettagliate , vedere Modifica di rilievo per il codice client che legge le informazioni di connessione .

2023-10-01-Preview

Questa versione include tutte le funzionalità introdotte nelle anteprime precedenti, oltre ad aggiunte e modifiche alle API di ricerca vettoriale. Aggiornamenti alle API di ricerca vettoriali rappresentano una modifica sostanziale rispetto alla versione 2023-07-01-Preview. Per informazioni sulla migrazione, vedere Aggiungere campi vettoriali e Create una query vettoriale.

Se si prevede di usare la nuova funzionalità di prefiltrazione, è necessario usare un indice creato dopo il 2023-10-01.

Create o aggiorna indice:

vectorSearch include definizioni per algorithms, profilese vectorizers:
- algorithms continua a supportare hnsw e ora supporta eknnanche , in riferimento a Gerarchica Navigable Small World (HNSW) e a vicini K più vicini (eKNN) completi. All'interno della sezione algoritmo è possibile definire più combinazioni denominate di parametri HNSW e eKNN. algorithmConfigurations Sostituisce all'interno della vectorSearch proprietà in 2023-07-01-Preview.
- profiles è una nuova definizione che specifica la configurazione dell'algoritmo. Si supponga, ad esempio, di avere configurazioni di algoritmi denominate HNSW-1, HSNW-2, eKNN-1. Un profilo può specificare HNSW-1.
- vectorizers è definito in un indice, ma usato in fase di query per incorporare una stringa di query di testo. Un vettore fa riferimento a un modello di incorporamento. Il servizio di ricerca effettua una chiamata al modello di incorporamento per vettorizzare la stringa di query di testo e quindi passa il risultato al motore di ricerca per una query vettoriale.
Nei campi vettoriali vectorSearchConfigurationsostituisce vectorSearchProfile . La vectorSearchProfile proprietà specifica il profilo di ricerca vettoriale da utilizzare nel campo.
Negli indici creati prima di questa versione dell'API, quando si chiama l'API 2023-10-01-Preview, nella richiesta è necessario modificare il campo per specificare un valore vectorSearchProfile finché il profilo specifica lo stesso algoritmo specificato in precedenza in vectorSearchConfiguration. Ad esempio, se la definizione di campo esistente specifica "vectorSearchConfiguration": "myHnsw", è necessario sostituirla con "vectorSearchProfile": "your profile name"e il profilo deve essere definito per fare riferimento allo stesso "algorithm": "myHnsw".

documenti Search:

vectorQueriesvectors sostituisce nel 2023-07-01-Preview
vectorQueries.vectorsvectors.values sostituisce nel 2023-07-01-Preview.
La query vettoriale è ora una struttura polimorfica. kind deve essere specificato per indicare il tipo di query vettore richiesto. "kind": "vector" significa che la query è un vettore, quindi il chiamante deve avere già vettorializzato la stringa di query di ricerca in un incorporamento vettore.
"exhaustive": "true" è una nuova proprietà specifica se eseguire una ricerca completa (forza bruta) k-near più vicina tra tutti i vettori all'interno dell'indice vettore.
vectorFilterMode è un nuovo parametro per specificare il prefiltering (impostazione predefinita per gli indici creati dopo il 2023-10-01) o postfiltering (impostazione predefinita sugli indici precedenti) nella query.

29 marzo 2024: le risposte GET non restituiscono più stringhe di connessione o chiavi. Per informazioni dettagliate , vedere Modifica di rilievo per il codice client che legge le informazioni sulla connessione .

2023-07-01-Preview

Importante

La deprecazione di questa versione di anteprima è stata annunciata il 15 aprile 2024 e verrà ritirata il 8 luglio 2024. Per informazioni sulla migrazione, vedere Aggiornare le API REST in Azure AI Search.

Questa versione include funzionalità delle anteprime precedenti, oltre al supporto per la ricerca vettoriale:

Nell'indice di ricerca assegnare Collection(Edm.Single) il tipo di dati sui campi che contengono una matrice di numeri a virgola mobile a precisione singola. Si tratta del tipo di dati per la nuova funzionalità di ricerca vettoriale, utilizzata per archiviare un oggetto di incorporamento generato per ogni campo documento. Nell'indice di ricerca specificare anche le proprietà di configurazione del vettore. Per queste API, vedere Create o Aggiorna indice.
I carichi di lavoro di indicizzazione vengono aggiornati per accettare i dati vettoriali. Vedere Aggiungere, aggiornare o eliminare documenti.
Parametri di query per la ricerca vettoriale. Vedere Search Documenti per questi parametri.
Ottenere statistiche del servizio: restituisce la quota e l'utilizzo dell'indice vettore per il servizio.
Ottenere statistiche indice: restituisce quota di indice vettore e utilizzo per l'indice di ricerca.
29 marzo 2024: le risposte GET non restituiscono più stringhe di connessione o chiavi. Per informazioni dettagliate , vedere Modifica di rilievo per il codice client che legge le informazioni sulla connessione .

2021-04-30-Preview

Questa versione di anteprima include tutte le funzionalità introdotte nel 2020-06-30-Preview, più aggiunte alle API seguenti:

L'alias di indice aggiunge un nome secondario usato per fare riferimento agli indici nelle richieste di query e indicizzazione. Le operazioni alias includono create, update, delete, get e list.
Identità gestite per le connessioni in uscita. Nuovi valori per le stringhe di connessione in Create o Aggiornare le connessioni di origine dati usando l'autenticazione e i ruoli Microsoft Entra ID anziché le credenziali o le chiavi del database hardcoded.
Il supporto delle identità gestite è supportato anche per le connessioni dell'insieme di credenziali delle chiavi, per le soluzioni di ricerca che integrano la crittografia predefinita con crittografia gestita dal cliente.
Altre lingue per la competenza cognitiva Traduzione testuale.
Altre queryLanguages per la ricerca semantica e il ortografico in Search Documenti (anteprima).
Parametro didascalia per richiedere facoltativamente didascalie dalla ricerca semantica in Search Documenti (anteprima).
Le configurazioni semantiche vengono specificate in Create o Update Index. Una configurazione semantica determina quali campi devono essere usati per classificazione semantica, didascalie, evidenziazioni e risposte.
Parametro semanticConfiguration necessario per le query semantiche in Search Documenti (anteprima).
29 marzo 2024: le risposte GET non restituiscono più stringhe di connessione o chiavi. Per informazioni dettagliate , vedere Modifica di rilievo per il codice client che legge le informazioni sulla connessione .

2020-06-30