Condividi tramite

Eseguire la migrazione del codice di classificazione semantica dalle versioni precedenti

  • Articolo

Se il codice di classificazione semantica è stato scritto in base alle API di anteprima anticipata, questo articolo identifica le modifiche al codice necessarie per la migrazione alle versioni api più recenti. Le modifiche di rilievo per il ranker semantico sono limitate alla logica di query nelle API recenti, ma se il codice è stato scritto rispetto alla versione di anteprima iniziale, potrebbe essere necessario modificare anche la configurazione semantica.

Modifiche di rilievo

Esistono due modifiche di rilievo per il ranker semantico tra le versioni dell'API REST:

  • searchFields è stato sostituito da semanticConfiguration nel 2021-04-30-preview
  • queryLanguage è stato ignorato a partire dal 2023-07-01-preview, ma ripristinato per la riscrittura della query nel 2024-11-01-preview

Altri aggiornamenti specifici della versione riguardano le nuove funzionalità, ma non interrompono il codice esistente e pertanto non causano modifiche di rilievo.

Se si usano gli SDK di Azure, più API sono state rinominate nel tempo. I log delle modifiche dell'SDK forniscono i dettagli.

Versioni API che forniscono la classificazione semantica

Controllare il codice per la versione dell'API REST o la versione del pacchetto SDK per verificare quale sia la classificazione semantica. Le versioni API seguenti hanno un certo livello di supporto per la classificazione semantica.

Tipo di versione Versione API REST Aggiornamenti del ranker semantico
iniziale Anteprima 2020-06-30 Aggiunge queryType=semantic ai documenti di ricerca
preview 2021-04-30-preview Aggiunge semanticConfiguration a Crea o aggiorna indice
preview 2023-07-01-preview Aggiorna semanticConfiguration. A partire dal 14 luglio 2023, gli aggiornamenti ai modelli semantici ospitati da Microsoft hanno reso indipendente dal linguaggio semantico la rimozione della proprietà per la queryLanguage classificazione semantica. Non viene apportata alcuna modifica di rilievo nel codice, ma la proprietà viene ignorata. I clienti sono stati invitati a rimuovere questa proprietà dal codice.
preview 2023-10-01-preview Aggiunge semanticQuery per inviare una query usata solo a scopo di reranking.
stabile 2023-11-01 Disponibile a livello generale. Sono state introdotte le modifiche apportate alla semanticConfiguration versione stabile. Se il codice è destinato a questa versione o versione successiva, è compatibile con le versioni api più recenti, a meno che non si adottino nuove funzionalità di anteprima.
preview 2024-05-01-preview Nessuna modifica
stabile 2024-07-01 Nessuna modifica
preview 2024-09-01-preview Nessuna modifica
preview 2024-11-01-preview Aggiunge la riscrittura della query. La proprietà è ora necessaria se si usa la riscrittura della query (anteprima).The queryLanguage property is now required if you use query rewrite (preview).

Log delle modifiche per Azure SDK

Gli SDK di Azure sono in base a una pianificazione di rilascio indipendente. È necessario controllare i log delle modifiche per determinare quali pacchetti forniscono funzionalità semantiche e se le API sono state rinominate.

2024-11-01-preview

  • Aggiunge la riscrittura della query ai documenti di ricerca.
  • Richiede queryLanguage per i carichi di lavoro di riscrittura delle query. Per un elenco di valori validi, vedere l'API REST.

2024-09-01-preview

Nessuna modifica alla sintassi di classificazione semantica dalla versione stabile 2024-07-01.

2024-07-01

Nessuna modifica alla sintassi di classificazione semantica dalla versione 2024-05-01-preview.

Non usare questa versione dell'API. Implementa una sintassi di query vettoriale incompatibile con qualsiasi versione più recente dell'API.

2024-05-01-preview

Nessuna modifica alla sintassi di classificazione semantica dalla versione 2024-03-01-preview.

2024-03-01-preview

Nessuna modifica alla sintassi di classificazione semantica dalla versione 2023-10-01-preview, ma vengono introdotte query vettoriali. La classificazione semantica si applica ora alle risposte dalle query ibride e vettoriali. È possibile applicare il reranking a qualsiasi campo di testo leggibile nella risposta, presupponendo che i campi siano elencati in prioritizedFields.

2023-11-01

  • SemanticDebug Esclude e semanticQuery, in caso contrario uguale alla versione 2023-10-01-preview.

2023-10-01-preview

  • Aggiunge semanticQuery

2023-07-01-preview

  • Aggiunge semanticErrorHandling, semanticMaxWaitInMilliseconds.
  • Aggiunge numerosi campi correlati alla semantica alla risposta, ad esempio SemanticDebug e SemanticErrorMode.
  • queryLanguageIgnora , non viene più usato nella classificazione semantica.

A partire dal 14 luglio 2023, il ranker semantico è indipendente dal linguaggio. Nelle versioni di anteprima, la classificazione semantica deprezza i risultati in modo diverso da quello querylanguage specificato dall'analizzatore dei campi. Tuttavia, la queryLanguage proprietà è ancora applicabile alla correzione ortografia e all'elenco breve di lingue supportate da tale funzionalità.

2021-04-30-preview

La searchFields proprietà non viene più utilizzata per assegnare priorità ai campi. In tutte le versioni in avanti, semanticConfiguration.prioritizedFields sostituisce searchFields come meccanismo per specificare i campi da usare per la classificazione L2.

Anteprima 2020-06-30

  • Il supporto semantico è tramite una chiamata API di anteprima documenti di ricerca.
  • Aggiunge queryType=semantic alla richiesta di query.
  • Adatta in searchFields modo che, se il tipo di query è semantico, la searchFields proprietà determina l'ordine di priorità degli input di campo al ranker semantico.
  • Aggiunge captions, answerse highlights alla risposta della query.

Passaggi successivi

Testare la migrazione della configurazione semantica eseguendo una query semantica.

Creare una query semantica