Condividi tramite

Versioni dell'API REST (Ricerca intelligenza artificiale di Azure)

  • Articolo

Questo articolo elenca le versioni correnti e precedenti delle API REST di ricerca per Ricerca di intelligenza artificiale di Azure.

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, viene visualizzato un selettore di versione sopra il sommario. Assicurarsi che il riferimento all'API provena dalla cartellariferimento piano dati.

Screenshot del selettore di versione.

Versioni stabili

Versione DELL'API Specificazione Aggiornamenti delle API
2024-07-01 (più recente) specifica Swagger nota sulla versione
2023-11-01 specifica Swagger nota sulla versione
2020-06-30 specifica Swagger nota sulla versione
2019-05-06 specifica Swagger Aggiunge tipi complessi.

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 supplementari per l'utilizzo per le anteprime di Microsoft Azure.

Versione DELL'API Specificazione Aggiornamenti delle API
2024-11-01-preview (più recente) specifica Swagger nota sulla versione
2024-09-01-preview specifica Swagger nota sulla versione
2024-05-01-preview specifica Swagger nota sulla versione
2024-03-01-preview specifica Swagger nota sulla versione
2023-10-01-preview specifica Swagger nota sulla versione
2023-07-01-preview (deprecato) specifica Swagger nota sulla versione
2021-04-30-preview specifica Swagger nota sulla versione
2020-06-30-preview specifica Swagger nota sulla versione
2019-05-06-preview specifica Swagger nota sulla versione

Note sulla versione

2024-11-01-preview

Questa anteprima si basa sul 2024-09-01-preview ed è inclusiva di tutte le funzionalità di attualmente in anteprima. È possibile eseguire l'aggiornamento da 2024-09-01-preview a 2024-11-01-preview con modifiche minime al codice. Per altre informazioni, vedere Aggiornare le API REST.

Aggiornare API REST applicabile
Riscrittura query nel reranker semantico, usato per perfezionare le query inviate al ranker L2. cerca documenti, nuova proprietà QueryRewritesType nella richiesta.
competenza Layout documento usato per analizzare un documento per la struttura. Creare o aggiornare il set di competenze, nuova competenza DocumentIntelligenceLayoutSkill.
Identità gestita per collegare una risorsa multiservizio di Azure ai. crea o aggiorna set di competenze, nuova proprietà AIServicesAccountIdentity.
modalità di analisi Markdown, usata per l'indicizzazione dei file Markdown in Archiviazione di Azure. Crea o aggiorna indicizzatore, nuova markdown modalità di analisi.
opzioni di rescoring per i vettori compressi, usato per la registrazione con vettori originali anziché con vettori compressi. Si applica agli algoritmi HNSW e a vettori KNN completi, usando la compressione binaria e scalare. Creare o aggiornare l'indice, nuove proprietà di rescoringOptions. Una nuova proprietà enableRescoring esegue il mapping a rerankWithOriginalVectors introdotta nel 2024-03-01-preview.

2024-09-01-preview

Questa anteprima si basa sul 2024-05-01-preview ed è inclusiva di tutte le funzionalità di attualmente in anteprima. È possibile eseguire l'aggiornamento da 2024-05-01-preview a 2024-09-01-preview senza alcuna modifica del codice necessaria. Per altre informazioni, vedere Aggiornare le API REST.

Aggiornare API REST applicabile
dimensioni troncate per la quantizzazione di Matryoshka Representation Learning (MRL) per i modelli di piccole dimensioni e text-embedding-3 di grandi dimensioni. Crea o aggiorna indice, nuovo parametro troncamentoDimension
Sottoscores or scoring details for unpacking hybrid search results scored by Reciprocal Rank Fusion (RRF). cerca documenti, nuova debug parametri e definizioni di sottolineatura secondaria di query nella risposta.
Filtro di destinazione per la parte vettoriale di una query di ricerca ibrida . Ricerca documenti, nuovo parametro filterOverride filterOverride in RawVectorQuery, VectorizableTextQuery, VectorizableImageUrlQuery, VectorizableImageBinaryQuery.
Suddivisione in blocchi di token in competenza Dividi testo, anziché solo caratteri. Create or Update Skillset, new unit parameter e altre proprietà correlate al token.

2024-07-01

Questa versione fornisce aggiornamenti a livello generale per la vettorizzazione integrata (competenze e vettorizzatori), la quantizzazione scalare e la quantizzazione binaria. Per informazioni dettagliate, vedere Novità di Ricerca di intelligenza artificiale di Azure.

Aggiornare API REST applicabile
Disponibile a livello generale: tipi di dati vettoriali Creare o aggiornare indice
Disponibile a livello generale: proprietà di quantizzazione vettoriale per la quantizzazione scalare o binaria predefinita in un indice di ricerca. Creare o aggiornare indice
Disponibile a livello generale: proprietà archiviata in un campo vettore che determina se è archiviata una copia aggiuntiva del campo. La copia aggiuntiva è il contenuto recuperabile di tale campo. Se non viene archiviato, 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. Creare o aggiornare indice
Disponibile a livello generale: parametri vectorizableTextQuery per l'ottimizzazione della pertinenza. I parametri di query ibridi (MaxTextSizeRecall) sono ancora in anteprima. ricerca documenti
Disponibile a livello generale: competenza AzureOpenAIEmbedding per supportare più modelli che semplicemente text-embedding-ada-002 per la vettorializzazione integrata durante l'indicizzazione. Impostare il nome del modello e le proprietà delle dimensioni per specificare come destinazione un modello specifico. Creare o aggiornare il set di competenze
Disponibile a livello generale: vettore di incorporamento di Azure OpenAI per la vettorializzazione integrata durante le query. Le proprietà del vettore supportano più modelli. Creare o aggiornare indice
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. Tutte le versioni

2024-05-01-preview

Questa anteprima aggiunge il supporto per l'indicizzazione, l'ottimizzazione della pertinenza e l'integrazione più approfondita con più modelli di incorporamento durante l'indicizzazione e le query. Si basa sul 2024-03-01-preview ed è inclusivo di tutte le funzionalità di attualmente in anteprima.

Per eseguire l'aggiornamento da 2024-03-01-preview o 2023-10-01-preview, aggiornare la competenza o il vettore AzureOpenAIEmbedding per includere il nome e le dimensioni del modello. Per eseguire l'aggiornamento da 2023-07-01-preview (deprecato) o per istruzioni dettagliate, vedere Aggiornare le API REST.

Ecco gli aggiornamenti in questa anteprima. È anche consigliabile Novità di Ricerca di intelligenza artificiale di Azure.

Aggiornare API REST applicabile
Origine dati dell'indicizzatore per i file e i collegamenti di OneLake. Creare o aggiornare l'origine dati
Collection(Edm.Byte), un tipo di dati binario per l'incorporamento di modelli che li supportano. Le definizioni dei campi vettoriali supportano questo tipo di dati. Creare o aggiornare indice
Più parametri di query vettoriali e ibridi per l'ottimizzazione della pertinenza. Impostare le soglie per escludere i risultati con punteggio basso. Query di vettori di peso. Per le query ibride, impostare il numero massimo di documenti da recuperare nella parte di testo di una query ibrida. ricerca documenti
Nuova competenza di Visione artificiale di Azure per la vettorializzazioneintegrataae durante l'indicizzazione. Questa competenza chiama l'API multimodale di Visione artificiale di Azure. Creare o aggiornare il set di competenze
Nuovo vectorizzatore di Visione artificiale di Azure per lequerye. Un vettore viene specificato nelle definizioni di indice, ma usato durante l'esecuzione della query. Creare o aggiornare indice
Aggiornamento della competenza AzureOpenAIEmbedding per supportare più modelli che semplicemente text-embedding-ada-002 per la vettorializzazione integrata durante l'indicizzazione. Impostare il nome del modello e le proprietà delle dimensioni per specificare come destinazione un modello specifico. Creare o aggiornare il set di competenze
Aggiornamento del vettore di incorporamento di Azure OpenAI per la vettorizzazione integrata durante le query. Le proprietà del vettore supportano più modelli. Creare o aggiornare indice
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. Tutte le versioni

2024-03-01-preview

Questa versione di anteprima si basa su 2023-10-01-preview aggiungendo API di anteprima che migliorano l'archiviazione vettoriale. Per informazioni dettagliate, vedere Novità di Ricerca di intelligenza artificiale di Azure.

Aggiornare API REST applicabile
Nuovi tipi di dati ristretti per i campi vettoriali se sono stati incorporati modelli che li supportano o la logica di quantizzazione che restituisce vettori più piccoli. Creare o aggiornare indice
Nuove proprietà di quantizzazione vettoriale per la compressione vettoriale predefinita in un indice di ricerca. Creare o aggiornare indice
Nuovo proprietà archiviata in un campo vettoriale che determina se viene archiviata una copia aggiuntiva del campo. La copia aggiuntiva è il contenuto recuperabile di tale campo. Se non viene archiviato, 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. Creare o aggiornare indice
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. Tutte le versioni

2023-11-01

Questa versione fornisce funzionalità disponibili a livello generale. Per informazioni dettagliate, vedere Novità di Ricerca di intelligenza artificiale di Azure.

Aggiornare API REST applicabile
Classificazione semantica nelle richieste post di ricerca. ricerca documenti
Configurazione della ricerca vettoriale per i campi vettoriali di indicizzazione Creare o aggiornare indice
Query vettoriali nelle richieste post di ricerca. ricerca documenti
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. Tutte le versioni

2023-10-01-preview

Questa versione include tutte le funzionalità introdotte nelle anteprime precedenti, oltre ad aggiunte e modifiche alle API di ricerca vettoriale. Gli aggiornamenti delle API di ricerca vettoriale sono una modifica che causa un'interruzione rispetto alla versione 2023-07-01-Preview. Per informazioni sulla migrazione, vedere Aggiungere campi vettoriali e Creare una query vettoriale.

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

Creare o aggiornare l'dell'indice :

  • vectorSearch include definizioni per algorithms, profilese vectorizers:

    • algorithms continua a supportare hnsw e ora supporta anche eknn, in riferimento a Gerarchiche Navigable Small World (HNSW) e ai vicini K più vicini completi (eKNN). All'interno della sezione dell'algoritmo è possibile definire più combinazioni denominate di parametri HNSW e eKNN. Questo sostituisce algorithmConfigurations all'interno della proprietà vectorSearch nel 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 potrebbe 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 vectorSearchProfile sostituisce vectorSearchConfiguration. La proprietà vectorSearchProfile 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 vectorSearchProfile purché il profilo specifichi esattamente 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".

ricerca documenti:

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

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-07-01-preview

Importante

Non usare questa versione dell'API. La deprecazione di questa versione di anteprima è stata annunciata il 15 aprile 2024 e non è più supportata dopo l'8 luglio 2024. Per informazioni sulla migrazione, vedere Aggiornare le API REST in Ricerca intelligenza artificiale di Azure.

Questa versione ha introdotto il supporto vettoriale e usa una configurazione vettoriale non compatibile con le versioni più recenti dell'API.

  • Aggiunta di un tipo di dati Collection(Edm.Single) nei campi che contengono una matrice di numeri a virgola mobile a precisione singola. Si tratta del tipo di dati per i vettori, usato per archiviare un campo di incorporamento generato per ogni campo documento. L'indice di ricerca specifica anche le proprietà di configurazione del vettore. Per queste API, vedere Creare o aggiornare l'indice.
  • Aggiornamento dei carichi di lavoro di indicizzazione per accettare i dati vettoriali. Vedere Aggiungere, aggiornare o eliminare documenti.
  • Aggiunta di parametri di query per la ricerca vettoriale. Per questi parametri, vedere cerca documenti.
  • Get Service Statistics: restituisce la quota e l'utilizzo dell'indice vettoriale per il servizio.
  • Get Index Statistics: restituisce la quota e l'utilizzo dell'indice vettoriale per l'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.

2021-04-30-preview

Questa versione di anteprima include tutte le funzionalità introdotte nella versione 2020-06-30-Preview, oltre alle API seguenti:

2020-06-30

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

  • Controllo degli accessi in base al ruolo di Azure per le operazioni del piano dati
  • Assegnazione dei punteggi per pertinenza (BM25)
  • Archivi conoscenze
  • Origine dati dell'indicizzatore per Azure Data Lake Storage (ADLS) Gen2
  • Competenza ricerca entità personalizzata
  • Indicizzatori in esecuzione in un'identità gestita dal sistema o dall'utente tramite Microsoft Entra ID
  • 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.

Anteprima 2020-06-30

Questa versione di anteprima include tutte le funzionalità introdotte nel 2019-05-06-Preview, oltre alle aggiunte seguenti:

  • Ricerca semantica, una funzionalità Premium eseguita nei servizi di livello Standard e che richiama la classificazione semantica.
  • Origine dati dell'indicizzatore per i connettori di Power Query
  • Origine dati dell'indicizzatore per MySQL
  • Origine dati dell'indicizzatore per l'API Gremlin di Cosmos DB
  • Origine dati dell'indicizzatore per SharePoint Online
  • Proprietà Normalizer per la normalizzazione del testo, per i filtri senza distinzione tra maiuscole e minuscole, facet e ordinamento
  • Reimpostare i documenti per l'indicizzazione basata su indicizzatore per aggiornare in modo specifico documenti specifici in base all'ID
  • Competenza cognitiva di Entity Linking (v3)
  • Competenza cognitiva riconoscimento entità (v3)
  • Competenza cognitiva di Analisi del sentiment (v3)
  • 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.

Anteprima 2019-05-06

  • Supporto dell'origine dati dell'indicizzatore per l'API MongoDB di Cosmos DB
  • Origine dati dell'indicizzatore per l'eliminazione temporanea nell'archiviazione BLOB
  • featuresMode parametro che restituisce informazioni dettagliate su un punteggio di pertinenza
  • Competenza cognitiva di Azure Machine Learning (AML)
  • Competenza cognitiva di rilevamento identificazione personale
  • Memorizzare nella cache i documenti arricchiti per conservare e riutilizzare l'elaborazione delle immagini (e altri arricchimenti tramite intelligenza artificiale)
  • 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.

Vedere anche