Spostare una knowledge base utilizzando la funzione di importazione ed esportazione

È possibile creare una copia della knowledge base per diversi motivi:

• Copiare una knowledge base dalla disponibilità generale di QnA Maker per una risposta a una domanda personalizzata
• Implementare il processo di backup e ripristino
• Eseguire l'integrazione con una pipeline CI/CD
• Spostare i dati in aree diverse

Nota

Il servizio QnA Maker sarà ritirato il 31 marzo 2025. Una versione più recente della funzionalità di domande e risposte è ora disponibile come parte di Lingua di Azure AI. Per le funzionalità di risposta alla domanda all'interno del servizio di linguaggio vedere Risposta alla domanda. A partire dal 1° ottobre 2022 non è più possibile creare nuove risorse di QnA Maker. Per informazioni sulla migrazione delle knowledge base di QnA Maker esistenti alla risposta alla domanda, fare riferimento alla guida alla migrazione.

Prerequisiti

• Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
• Una risorsa QnA Maker creata nel portale di Azure. Prendere nota dell’istanza di Microsoft Entra ID, della sottoscrizione e del nome della risorsa Qna selezionati al momento della creazione della risorsa.
• Configurare un nuovo servizio QnA Maker

Esportare una knowledge base

1. Accedere al portale di QnA Maker.

2. Selezionare la knowledge base da spostare.

3. Nella pagina delle Impostazioni sono disponibili le opzioni per esportare Domande e risposte, Sinonimi o Replica della knowledge base. È possibile scegliere di scaricare i dati in .tsv/.xlsx.

   1. Domande e risposte: durante l'esportazione di domande e risposte, vengono scaricate tutte le coppie di domanda e risposta (con domande, risposte, metadati, richieste di completamento e i nomi origine dati). Gli ID esportati con le domande e le risposte possono essere usati per aggiornare una coppia di domanda e risposta specifica usando l' API di aggiornamento. L'ID per una coppia di domanda e risposta specifica rimane invariato per più operazioni di esportazione.
   2. Sinonimi: è possibile esportare i sinonimi aggiunti alla knowledge base.
   3. Replica della knowledge base: è possibile scegliere questa opzione per scaricare l'intera knowledge base con sinonimi e altre impostazioni.

Importare una knowledge base

1. Selezionare Crea una knowledge base dal menu superiore del portale di qnamaker.ai e quindi creare una knowledge basevuota senza aggiungere alcun URL o file. Impostare il nome scelto per la nuova knowledge base e quindi fare clic su Crea knowledge base.

2. In questa nuova knowledge base aprire la scheda Impostazioni e in Importa knowledge base selezionare una delle opzioni seguenti: Domande e risposte, Sinonimio Replica della knowledge base.

   1. Domande e risposte: questa opzione importa tutte le coppie di domanda e risposta. Le coppie di domanda e risposa create nella nuova knowledge base avranno lo stesso ID presente nel file esportato. È possibile fare riferimento ai file SampleQnAs.xlsx, SampleQnAs.tsv per importare domande e risposte.

   2. Sinonimi: questa opzione può essere usata per importare i sinonimi nella knowledge base. È possibile fare riferimento ai file SampleSynonyms.xlsx, SampleSynonyms.tsv per importare i sinonimi.

   3. Replica della knowledge base: questa opzione può essere usata per importare la replica della knowledge base con domande e risposte, sinonimi e impostazioni. Per maggiori informazioni è possibile fare riferimento ai file KBReplicaSampleExcel, KBReplicaSampleTSV. Per aggiungere contenuto non strutturato alla replica vedere CustomQnAKBReplicaSample.

      Durante l'importazione della replica sono necessari le domande e risposte o il contenuto non strutturato. I documenti non strutturati sono validi solo per la risposta alla domanda personalizzata. Il file dei sinonimi non è obbligatorio durante l'importazione della replica. Il file delle impostazioni è obbligatorio durante l'importazione della replica.

      Impostazione	Aggiornamento consentito durante l'importazione nella knowledge base di QnA Maker?	Aggiornamento consentito durante l'importazione nella knowledge base di risposta alla domanda personalizzata?
      DefaultAnswerForKB	No	Sì
      EnableActiveLearning (vero/falso)	Sì	No
      EnableMultiTurnExtraction (vero/falso)	Sì	Sì
      DefaultAnswerforMultiturn	Sì	Sì
      Lingua	No	No

3. Testare la nuova knowledge base mediante il pannello di Test. Leggere le informazioni su come testare la knowledge base.

4. Pubblicare la knowledge base e creare un chatbot. Leggere le informazioni su come pubblicare la knowledge base.

   

Esportare a livello di programmazione una knowledge base da QnA Maker

Il processo di esportazione/importazione è disponibile a livello di programmazione usando le API REST seguenti:

Esportazione

• Scaricare l’API knowledge base

Importa

• Sostituire l'API (ricaricare con lo stesso ID della knowledge base)
• Creare l'API (caricare con un nuovo ID della knowledge base)

Log di chat

Non è possibile esportare i log delle chat, poiché la nuova knowledge base usa Application Insights per archiviare i log delle chat.

Passaggi successivi

Modificare una knowledge base