Funzionalità di anteprima in Azure AI Search
Questo articolo identifica tutte le funzionalità del piano dati e del piano di controllo in anteprima pubblica. Questo elenco è utile per controllare lo stato delle funzionalità. Viene inoltre illustrato come chiamare un'API REST di anteprima.
Le versioni delle API di anteprima sono cumulative e vengono riportate nella successiva anteprima. È consigliabile usare sempre le API di anteprima più recenti per l'accesso completo a tutte le funzionalità di anteprima.
Le funzionalità di anteprima vengono rimosse da questo elenco se vengono ritirate o passano alla disponibilità generale. Per gli annunci relativi alla disponibilità generale e al ritiro, vedere Aggiornamenti del servizio o Novità.
Funzionalità di anteprima del piano dati
| Funzionalità | Categoria | Descrizione | Disponibilità |
|---|---|---|---|
| Riscrittura delle query nel reranker semantico | Pertinenza (punteggio) | È possibile impostare opzioni su una query semantica per riscrivere l'input della query in una query modificata o espansa che genera risultati più pertinenti dal ranker L2. | Cercare documenti (anteprima). |
| Competenza Layout documento | Intelligenza artificiale applicata (competenze) | Nuova competenza usata per analizzare un documento per la struttura e fornire la suddivisione in blocchi in grado di conoscere la struttura. | Creare o aggiornare il set di competenze (anteprima). |
| Fatturazione senza chiave per l'elaborazione delle competenze di Intelligenza artificiale di Azure. | Intelligenza artificiale applicata (competenze) | È ora possibile usare un'identità gestita e i ruoli per una connessione senza chiave ai servizi di intelligenza artificiale di Azure per l'elaborazione predefinita delle competenze. Questa funzionalità rimuove le restrizioni per avere sia i servizi di ricerca che di intelligenza artificiale nella stessa area. | Creare o aggiornare il set di competenze (anteprima). |
| Modalità di analisi markdown | Origine dati dell'indicizzatore | Con questa modalità di analisi, gli indicizzatori possono generare documenti di ricerca uno-a-uno o uno-a-molti da file Markdown in Archiviazione di Azure. | Creare o aggiornare un indicizzatore (anteprima). |
| Opzioni di rescoring per vettori compressi | Pertinenza (punteggio) | È possibile impostare le opzioni per ripetere il carattere di sottolineatura con vettori originali anziché vettori compressi. Si applica agli algoritmi HNSW e a vettori KNN completi, usando la compressione binaria e scalare. | Creare o aggiornare l'indice (anteprima). |
| Ridurre i requisiti di dimensione per i modelli di incorporamento di testo con training MRL in Azure OpenAI | Indice | Il training di text-embedding-3-small e Text-embedding-3-large viene eseguito usando Matryoshka Representation Learning (MRL). In questo modo è possibile troncare i vettori di incorporamento in un minor numero di dimensioni e regolare il bilanciamento tra l'utilizzo delle dimensioni dell'indice vettoriale e la qualità del recupero. Un nuovo truncationDimension fornisce i comportamenti MRL come parametro aggiuntivo in una configurazione di compressione vettoriale. Questa opzione può essere configurata solo per i nuovi campi vettoriali. |
Creare o aggiornare l'indice (anteprima). |
Decomprimere @search.score per visualizzare i caratteri di sottolineatura nei risultati della ricerca ibrida |
Pertinenza (punteggio) | È possibile esaminare i risultati classificati RRF (Reciprocal Rank Fusion) visualizzando i singoli caratteri di sottolineatura della query del risultato finale unito e con punteggio. Una nuova debug proprietà decomprime il punteggio di ricerca. QueryResultDocumentSubscores, QueryResultDocumentRerankerInpute QueryResultDocumentSemanticField forniscono i dettagli aggiuntivi. |
Cercare documenti (anteprima). |
| Filtri di destinazione in una ricerca ibrida solo per le query vettoriali | Query | Un filtro per una query ibrida comporta tutte le sottoquery nella richiesta, indipendentemente dal tipo. È possibile eseguire l'override del filtro globale per definire l'ambito del filtro in una sottoquery specifica. Un nuovo filterOverride parametro fornisce i comportamenti. |
Cercare documenti (anteprima). |
| Competenza Divisione testo (suddivisione in blocchi di token) | Intelligenza artificiale applicata (competenze) | Questa competenza include nuovi parametri che migliorano la suddivisione in blocchi dei dati per i modelli di incorporamento. Un nuovo unit parametro consente di specificare la suddivisione in blocchi dei token. È ora possibile suddividere in blocchi in base alla lunghezza del token, impostando la lunghezza su un valore appropriato per il modello di incorporamento. È anche possibile specificare il tokenizer e tutti i token che non devono essere suddivisi durante la suddivisione in blocchi dei dati. |
Creare o aggiornare il set di competenze (anteprima). |
| Competenza di incorporamenti multimodale di Visione di Azure AI | Intelligenza artificiale applicata (competenze) | Nuovo tipo di competenza che chiama l'API multimodale di Visione di Azure AI per generare incorporamenti per testo o immagini durante l'indicizzazione. | Creare o aggiornare il set di competenze (anteprima). |
| Competenza di Azure Machine Learning (AML) | Intelligenza artificiale applicata (competenze) | Competenza AML che integra un endpoint di inferenza da Azure Machine Learning. Nelle API di anteprima precedenti supporta le connessioni ai modelli personalizzati distribuiti in un'area di lavoro AML. A partire dall'anteprima 2024-05-01-preview, è possibile usare questa competenza nei flussi di lavoro che si connettono ai modelli di incorporamento nel catalogo dei modelli di Studio AI della piattaforma Azure. È disponibile anche nel portale, nella progettazione del set di competenze, presupponendo che i servizi Azure AI Search e Azure Machine Learning vengano distribuiti nella stessa sottoscrizione. | Creare o aggiornare il set di competenze (anteprima). |
| Cache di arricchimento incrementale | Intelligenza artificiale applicata (competenze) | Aggiunge la memorizzazione nella cache a una pipeline di arricchimento, consentendo di riutilizzare l'output esistente se una modifica specifica, ad esempio un aggiornamento a un set di competenze o un altro oggetto, non modifica il contenuto. La memorizzazione nella cache si applica solo ai documenti arricchiti prodotti da un set di competenze. | Creare o aggiornare un indicizzatore (anteprima). |
| Indicizzatore di file OneLake | Origine dati dell'indicizzatore | Nuova origine dati per l'estrazione di dati e metadati ricercabili da un lakehouse in OneLake | Creare o aggiornare l'origine dati (anteprima). |
| Indicizzatore di File di Azure | Origine dati dell'indicizzatore | Nuova origine dati per l'indicizzazione basata su indicizzatore da File di Azure | Creare o aggiornare l'origine dati (anteprima). |
| Indicizzatore di SharePoint online | Origine dati dell'indicizzatore | Nuova origine dati per l'indicizzazione basata su indicizzatore del contenuto di SharePoint. | Iscriversi per abilitare la funzionalità. Creare o aggiornare l'origine dati (anteprima) o il portale di Azure. |
| Indicizzatore MySQL | Origine dati dell'indicizzatore | Nuova origine dati per l'indicizzazione basata su indicizzatore di origini dati MySQL di Azure. | Iscriversi per abilitare la funzionalità. Creare o aggiornare l'origine dati (anteprima), .NET SDK 11.2.1 e il portale di Azure. |
| indicizzatore di Azure Cosmos DB for MongoDB | Origine dati dell'indicizzatore | Nuova origine dati per l'indicizzazione basata su indicizzatore tramite le API MongoDB in Azure Cosmos DB. | Iscriversi per abilitare la funzionalità. Creare o aggiornare l'origine dati (anteprima) o il portale di Azure. |
| Indicizzatore di Azure Cosmos DB for Apache Gremlin | Origine dati dell'indicizzatore | Nuova origine dati per l'indicizzazione basata su indicizzatore tramite le API Apache Gremlin in Azure Cosmos DB. | Iscriversi per abilitare la funzionalità. Creare o aggiornare l'origine dati (anteprima). |
| Eliminazione temporanea del BLOB nativo | Origine dati dell'indicizzatore | Si applica all'indicizzatore di Archivio BLOB di Azure. Riconosce i BLOB in uno stato di eliminazione temporanea e rimuove il documento di ricerca corrispondente durante l'indicizzazione. | Creare o aggiornare l'origine dati (anteprima). |
| Reimposta documenti | Indicizzatore | Rielabora i documenti di ricerca selezionati singolarmente nei carichi di lavoro dell'indicizzatore. | Reimpostare documenti. |
| correttore ortografico | Query | Correzione ortografica facoltativa sugli input dei termini di query per query semplici, complete e semantiche. | Cercare documenti (anteprima). |
| Normalizzatori | Query | I normalizzatori offrono la pre-elaborazione di testo semplice: maiuscole e minuscole coerenti, rimozione principale e riduzione ASCII, senza richiamare la catena di analisi full-text. | Cercare documenti (anteprima). |
| Parametro featuresMode | Pertinenza (punteggio) | Espansione del punteggio di pertinenza BM25 per includere i dettagli: punteggio di somiglianza per campo, frequenza del termine del campo e numero di token univoci corrispondenti. È possibile utilizzare questi punti dati in soluzioni di assegnazione dei punteggi personalizzate. | Cercare documenti (anteprima). |
| Parametro vectorQueries.threshold | Pertinenza (punteggio) | Escludere il risultato della ricerca con punteggio basso in base a un punteggio minimo. | Cercare documenti (anteprima). |
| Parametri hybridSearch.maxTextRecallSize e countAndFacetMode | Pertinenza (punteggio) | modificare gli input di una query ibrida controllando la quantità di risultati sulla pertinenza basati su BM25 che vengono trasmessi al modello di classificazione ibrida. | Cercare documenti (anteprima). |
| moreLikeThis | Query | Trova documenti rilevanti per un documento specifico. Questa funzionalità è stata presente nelle anteprime precedenti. | Cercare documenti (anteprima). |
Funzionalità di anteprima del piano di controllo
| Funzionalità | Categoria | Descrizione | Disponibilità |
|---|---|---|---|
| Perimetro di sicurezza della rete | Service | Aggiungere un servizio di ricerca a un perimetro di sicurezza di rete per controllare l'accesso alla rete al servizio di ricerca. | Le API perimetrali per la sicurezza di rete portale di Azure e 2024-06-01-preview. |
| Servizio di ricerca in un'identità gestita assegnata dall'utente | Service | Configura un servizio di ricerca per l'uso di un'identità gestita assegnata dall'utente creata in precedenza. | Servizi: aggiornamento, 2021-04-01-preview o versione di anteprima più recente. È consigliabile usare la versione di anteprima più recente. |
Funzionalità di anteprima in Azure SDK
Ogni team di Azure SDK rilascia i pacchetti beta nella propria sequenza temporale. Controllare il log delle modifiche per le menzioni delle nuove funzionalità nei pacchetti beta:
- Log delle modifiche per Azure SDK per .NET
- Log delle modifiche per Azure SDK per Java
- Log delle modifiche per Azure SDK per JavaScript
- Log delle modifiche per Azure SDK per Python.
Uso delle funzionalità in anteprima
Le funzionalità sperimentali sono disponibili prima tramite l'API REST di anteprima, seguita dal portale di Azure e quindi dagli SDK di Azure.
Alle funzionalità di anteprima si applicano le istruzioni seguenti:
- Le funzionalità di anteprima sono disponibili nelle Condizioni per l'utilizzo supplementari, senza alcun contratto di servizio.
- Le funzionalità di anteprima potrebbero subire modifiche di rilievo se è necessaria una riprogettazione.
- A volte le funzionalità di anteprima non sono seguite da una versione con disponibilità generale.
Se si scrive codice per un'API di anteprima, è necessario essere pronti ad aggiornare il codice alle versioni dell'API più recenti quando vengono distribuite. Manteniamo aggiornato un documento Aggiornare le API REST per semplificare questo passaggio.
Come chiamare un'API REST di anteprima
L'accesso alle API REST di anteprima viene eseguito tramite il parametro api-version nell'URI. Le anteprime meno recenti sono ancora operative, ma diventano obsolete nel tempo e non vengono aggiornate con nuove funzionalità o correzioni di bug.
Per le operazioni del piano dati sul contenuto, 2024-05-01-preview è la versione di anteprima più recente. Nell'esempio seguente viene illustrata la sintassi per GET indici (anteprima):
GET {endpoint}/indexes('{indexName}')?api-version=2024-05-01-Preview
Per le operazioni di gestione sul servizio di ricerca, 2024-06-01-preview è la versione di anteprima più recente. L'esempio seguente illustra la sintassi per la versione del servizio di aggiornamento 2024-06-01-preview.
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-06-01-preview
{
"tags": {
"app-name": "My e-commerce app",
"new-tag": "Adding a new tag"
},
"properties": {
"replicaCount": 2
}
}