Eseguire la migrazione da Knowledge Base di QnA Maker alla risposta personalizzata alla domanda

  • Articolo

Risposta personalizzata alle domande è una funzionalità di Lingua di Azure AI introdotta a maggio 2021 con diverse novità, tra cui una pertinenza migliorata grazie a un classificatore di Deep Learning, risposte precise e un supporto aree end-to-end. Ogni progetto di Risposta personalizzata alle domande equivale a una knowledge base in QnA Maker. È possibile eseguire facilmente la migrazione di una knowledge base da una risorsa di QnA Maker a un progetto di Risposta personalizzata alle domande all'interno di una risorsa linguistica. È possibile anche scegliere di eseguire la migrazione di knowledge base da più risorse di QnA Maker a una specifica risorsa linguistica.

Per eseguire correttamente la migrazione di una knowledge base, l'account che esegue la migrazione deve disporre dell'accesso come collaboratore a QnA Maker e alla risorsa linguistica selezionata. Quando viene eseguita la migrazione di una knowledge base, nel nuovo progetto di Risposta personalizzata alle domande vengono copiati i dettagli seguenti:

  • Coppie di domande e risposte, inclusi suggerimenti di apprendimento attivo.
  • Sinonimi e risposte predefinite dalla risorsa di QnA Maker.
  • Il nome della knowledge base viene copiato nel campo di descrizione del progetto.

Non vengono migrate alla nuova risorsa le impostazioni a livello di risorsa, ad esempio il controllo degli accessi in base al ruolo. Queste impostazioni devono essere quindi riconfigurate per la risorsa linguistica successivamente alla migrazione. Sarà anche necessario riabilitare l'analisi per la risorsa linguistica.

Procedura per la migrazione di SDK

L'obiettivo di questa Guida alla migrazione di SDK è quello di consentire la migrazione alla nuova libreria client di Risposta alle domande personalizzata, Azure.AI.Language.QuestionAnswering, dalla libreria client precedente, Microsoft.Azure.CognitiveServices.Knowledge.QnAMaker. Si incentra soprattutto sul confronto di operazioni simili tra i due pacchetti.

Procedura per la migrazione di knowledge base

Per eseguire la migrazione delle knowledge base, seguire questa procedura:

  1. Creare una risorsa linguistica in cui è abilitata la funzionalità Risposta alle domande personalizzata. Quando si crea una risorsa linguistica nel portale di Azure, verrà visualizzata l'opzione che consente di abilitare Risposta personalizzata alle domande. Se si seleziona questa opzione e si procede, verranno richiesti i dettagli di Ricerca di Azure per salvare le Knowledge Base.

  2. Se si desidera aggiungere alla risorsa linguistica knowledge base in più lingue, visitare Language Studio per creare il primo progetto di Risposta personalizzata alle domande e selezionare la prima opzione come illustrato di seguito. Le impostazioni di lingua di una risorsa linguistica possono essere specificate solo durante la creazione di un progetto. Se si desidera migrare nella risorsa linguistica knowledge base esistenti in una sola lingua, è possibile ignorare questo passaggio.

    Screenshot della schermata di scelta dell'interfaccia utente della lingua

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

    Pulsante Avvia migrazione visualizzato in un banner in qnamaker.ai

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

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

  5. Selezionare la risorsa QnA Maker contenente le knowledge base di cui eseguire la migrazione.

    Eseguire la migrazione di QnAMaker con casella di selezione rossa intorno all'opzione di selezione della risorsa QnAMaker

  6. Selezionare la risorsa linguistica in cui si desidera migrare le knowledge base. Sarà possibile visualizzare soltanto le risorse linguistiche in cui è abilitata la funzionalità Risposta personalizzata alle domande. La lingua relativa alla risorsa linguistica può essere impostata nelle opzioni. Se l'impostazione della lingua non è specificata, non è possibile eseguire la migrazione di Knowledge Base in più lingue da una risorsa di QnA Maker a una risorsa linguistica.

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

    Se si desidera migrare nella risorsa linguistica knowledge base in più lingue, è necessario abilitare l'impostazione corrispondente durante la creazione del primo progetto di Risposta personalizzata alle domande per la risorsa linguistica. A questo scopo, seguire le istruzioni fornite nel passaggio 2. Se per la risorsa linguistica non è specificata l'impostazione della lingua, viene assegnata la lingua della risorsa di QnA Maker selezionata.

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

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

  8. È possibile esaminare le knowledge base di cui si intende eseguire la migrazione. Potrebbero verificarsi errori di convalida nei nomi dei progetti, poiché nei progetti di Risposta personalizzata alle domande vengono seguite regole di convalida più rigide. Per risolvere questi errori causati da caratteri non validi, selezionare la casella di controllo (in rosso) e selezionare Avanti. In questo modo è possibile sostituire con un clic i caratteri che creano errori nel nome con caratteri accettati. Se è presente un duplicato, viene automaticamente generato un nuovo nome di progetto univoco.

    Attenzione

    Se si esegue la migrazione di una knowledge base con lo stesso nome di un progetto già esistente nella risorsa linguistica di destinazione, il contenuto del progetto verrà sostituito dal contenuto della knowledge base selezionata.

    Screenshot di un messaggio di errore che avvia i nomi dei progetti non può contenere caratteri speciali.

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

    Screenshot con caratteri speciali rimossi.

  10. Il completamento della migrazione richiederà alcuni minuti. Non annullare la migrazione mentre è in corso. È possibile passare ai progetti migrati all'interno di Language Studio solo dopo la migrazione.

    Screenshot delle Knowledge Base di cui è stata eseguita la migrazione con informazioni che è possibile pubblicare tramite Language Studio.

    Se la migrazione di una knowledge base in un progetto di Risposta personalizzata alle domande ha esito negativo, 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 una knowledge base vuota (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 copierà soltanto le istanze di test delle knowledge base. Al termine della migrazione, sarà necessario distribuire manualmente le Knowledge Base per copiare l'indice di test nell'indice di produzione.

Passaggi successivi