Eseguire la migrazione da QnA Maker a una risposta alla domanda personalizzata

Nota

È anche possibile eseguire la migrazione ad Azure OpenAI.

La risposta alle domande personalizzata, una funzionalità del linguaggio di intelligenza artificiale di Azure è stata introdotta nel maggio 2021 con diverse nuove funzionalità, tra cui una rilevanza migliorata usando un classificatore di deep learning, risposte precise e supporto per aree end-to-end. Ogni progetto di risposta alle domande personalizzate equivale a un knowledge base in QnA Maker. È possibile eseguire facilmente la migrazione di knowledge base da una risorsa QnA Maker a progetti di risposta alle domande personalizzate all'interno di una risorsa del linguaggio. È anche possibile scegliere di eseguire la migrazione delle knowledge base da più risorse di QnA Maker a una risorsa del linguaggio specifica.

Per eseguire correttamente la migrazione delle knowledge base, l'account che esegue la migrazione richiede l'accesso di collaboratore alla risorsa QnA Maker e lingua selezionata. Quando viene eseguita la migrazione di un knowledge base, i dettagli seguenti vengono copiati nel nuovo progetto di risposta alle domande personalizzate:

  • Coppie QnA che includono suggerimenti di apprendimento attivi.
  • Sinonimi e risposte predefinite dalla risorsa QnA Maker.
  • Il nome della Knowledge Base viene copiato nel campo della descrizione del progetto.

Le impostazioni a livello di risorsa, ad esempio controllo degli accessi in base al ruolo, non vengono migrate alla nuova risorsa. Queste impostazioni a livello di risorsa devono essere riconfigurate per la risorsa della lingua dopo la migrazione. Sarà anche necessario riabilitare l'analisi per la risorsa del linguaggio.

Passaggi per la migrazione degli SDK

Questa guida alla migrazione dell'SDK è destinata alla migrazione alla nuova libreria client di risposte alle domande, Azure.AI.Language.QuestionAnswering, da quella precedente, Microsoft.Azure.CognitiveServices.Knowledge.QnAMaker. Si concentra sui confronti side-by-side per operazioni simili tra i due pacchetti.

Passaggi per la migrazione delle knowledge base

È possibile seguire la procedura seguente per eseguire la migrazione delle knowledge base:

  1. Creare una risorsa della lingua con risposte alle domande personalizzate abilitate in anticipo. Quando si crea la risorsa della lingua nella portale di Azure, verrà visualizzata l'opzione per abilitare la risposta a domande personalizzate. Quando si seleziona l'opzione e si procede, verrà richiesto di salvare le knowledge base per i dettagli di Ricerca di Azure.

  2. Per aggiungere knowledge base in più lingue alla risorsa della lingua, visitare Language Studio per creare il primo progetto di risposta alle domande personalizzate e selezionare la prima opzione come illustrato di seguito. Le impostazioni della lingua per la risorsa della lingua possono essere specificate solo quando si crea un progetto. Per eseguire la migrazione delle knowledge base esistenti in una singola lingua alla risorsa del linguaggio, è possibile ignorare questo passaggio.

    Screenshot della schermata scelta dell'interfaccia utente della lingua

  3. Visitare https://www.qnamaker.ai e selezionare Avvia migrazione nella nota di migrazione nella pagina knowledge base. Verrà aperta una finestra di dialogo per avviare la migrazione.

    Pulsante Avvia migrazione visualizzato in un banner in qnamaker.ai

  4. Compilare i dettagli necessari per avviare la migrazione. Il tenant verrà selezionato automaticamente. È possibile scegliere di cambiare il tenant.

    Eseguire la migrazione di QnAMaker con la casella di selezione rossa intorno all'opzione di selezione del tenant

  5. Selezionare la risorsa QnA Maker che contiene le knowledge base da eseguire la migrazione.

    Eseguire la migrazione di QnAMaker con la casella di selezione rossa intorno all'opzione di selezione delle risorse QnAMaker

  6. Selezionare la risorsa del linguaggio in cui si vuole eseguire la migrazione delle knowledge base. Sarà possibile visualizzare solo le risorse del linguaggio che dispongono di risposte alle domande personalizzate abilitate. L'impostazione della lingua per la risorsa della lingua viene visualizzata nelle opzioni. Non sarà possibile eseguire la migrazione delle knowledge base in più lingue dalle risorse di QnA Maker a una risorsa del linguaggio se l'impostazione della lingua non è specificata.

    Eseguire la migrazione di QnAMaker con la casella di selezione rossa intorno all'opzione risorsa della lingua attualmente selezionata contiene le informazioni non specificate dalla lingua

    Se si desidera eseguire la migrazione delle knowledge base in più lingue alla risorsa della lingua, è necessario abilitare l'impostazione di più lingue durante la creazione del primo progetto di risposta alle domande personalizzate per la risorsa della lingua. È possibile eseguire questa operazione seguendo le istruzioni nel passaggio 2. Se l'impostazione della lingua per la risorsa della lingua non è specificata, viene assegnata la lingua della risorsa QnA Maker selezionata.

  7. Selezionare tutte le knowledge base di cui si vuole eseguire la migrazione > selezionare Avanti.

    Eseguire la migrazione di QnAMaker con la casella di selezione rossa intorno all'opzione di selezione knowledge base con un elenco a discesa che visualizza tre nomi knowledge base

  8. È possibile esaminare le knowledge base che si prevede di eseguire la migrazione. Potrebbero verificarsi alcuni errori di convalida nei nomi dei progetti perché si seguono regole di convalida più rigorose per i progetti di risposta alle domande personalizzate. Per risolvere questi errori dovuti a caratteri non validi, selezionare la casella di controllo (in rosso) e selezionare Avanti. Si tratta di un metodo con un clic per sostituire i caratteri problematici nel nome con i caratteri accettati. Se è presente un duplicato, un nuovo nome di progetto univoco viene generato dal sistema.

    Attenzione

    Se si esegue la migrazione di un knowledge base con lo stesso nome di un progetto già presente nella risorsa del linguaggio di destinazione, il contenuto del progetto verrà sottoposto a override dal contenuto del knowledge base selezionato.

    Screenshot di un messaggio di errore che avvia i nomi di progetto non può contenere caratteri speciali

  9. Dopo aver risolto gli errori di convalida, selezionare Avvia migrazione

    Screenshot con caratteri speciali rimossi

  10. La migrazione richiederà alcuni minuti. Non annullare la migrazione mentre è in corso. È possibile passare ai progetti migrati all'interno della migrazione dopo la migrazione.

    Screenshot delle knowledge base migrate correttamente con informazioni che è possibile pubblicare usando Language Studio

    Se le knowledge base non riescono a eseguire la migrazione ai progetti di risposta alle domande personalizzate, verrà visualizzato un errore. Gli errori di migrazione più comuni si verificano quando:

    • Le risorse di origine e di destinazione non sono valide.
    • Si sta tentando di eseguire la migrazione di un knowledge base vuoto (KB).
    • È stato raggiunto il limite per un'istanza di Ricerca di Azure collegata alle risorse di destinazione.

    Screenshot di una migrazione non riuscita con un errore di esempio

    Dopo aver risolto questi errori, è possibile eseguire nuovamente la migrazione.

  11. La migrazione copia solo le istanze di test delle knowledge base. Al termine della migrazione, è necessario distribuire manualmente le knowledge base per copiare l'indice di test nell'indice di produzione.

Passaggi successivi