Ciclo di vita della knowledge base in QnA Maker
QnA Maker apprende meglio in un ciclo iterativo di modifiche ai modelli, esempi di espressioni, pubblicazione e raccolta dei dati dalle query degli endpoint.
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, vedere la guida alla migrazione.
Creazione di una knowledge base di QnA Maker
L'endpoint della knowledge base (KB) di QnA Maker fornisce una risposta scelta in base alla corrispondenza migliore per una query utente basata sul contenuto della KB. La creazione di una knowledge base è un'operazione occasionale di configurazione di un repository di contenuti con domande, risposte e i metadati associati. È possibile creare una knowledge base eseguendo la ricerca per indicizzazione di contenuti preesistenti, come le origini seguenti:
- Pagine di domande frequenti
- Manuali di prodotti
- Coppie di domande e risposte
Leggere le informazioni su come creare una knowledge base.
Test e aggiornamento della knowledge base
La knowledge base è pronta per i test dopo essere stata popolata con il contenuto, a livello editoriale o tramite estrazione automatica. I test interattivi possono essere eseguiti nel portale di QnA Maker tramite il pannello Test. Si immettono query utente comuni. Verificare quindi che le risposte siano restituite con la risposta corretta e un punteggio di attendibilità sufficiente.
- Per correggere i punteggi di attendibilità bassi: aggiungere domande alternative.
- Quando una query restituisce erroneamente la risposta predefinita: aggiungere nuove risposte alla domanda corretta.
Questo ciclo serrato di test-aggiornamento continua finché non si è soddisfatti dei risultati. Leggere le informazioni su come testare la knowledge base.
Per le knowledge base di grandi dimensioni, usare test automatizzati con l'API GenerateAnswer e la proprietà del corpo isTest
, che esegue una query sulla knowledge base test
anziché sulla knowledge base pubblicata.
{
"question": "example question",
"top": 3,
"userId": "Default",
"isTest": true
}
Pubblicare la knowledge base
Una volta testata la knowledge base, è possibile pubblicarla. La pubblicazione esegue il push della versione più recente della knowledge base testata in un indice di Azure AI Search dedicato che rappresenta la knowledge base pubblicata. Viene inoltre creato un endpoint che può essere chiamato nell'applicazione o nel chat bot.
A causa dell'azione di pubblicazione, eventuali ulteriori modifiche apportate alla versione di test della knowledge base lasciano invariata la versione pubblicata. La versione pubblicata potrebbe essere attiva in un'applicazione di produzione.
Ognuna di queste knowledge base può essere scelta come destinazione per i test separatamente. Usando le API, è possibile scegliere come destinazione la versione di test della knowledge base con la proprietà del corpo isTest
nella chiamata GenerateAnswer.
Leggere le informazioni su come pubblicare la knowledge base.
Monitorare l'utilizzo
Per poter registrare i log di chat del servizio, è necessario abilitare Application Insights quando si crea un servizio QnA Maker.
È possibile ottenere diverse analisi relative all'utilizzo del servizio. Leggere altre informazioni su come usare Application Insights per ottenere analisi per il servizio QnA Maker.
In base alle informazioni ottenute dall'analisi, apportare aggiornamenti alla knowledge base come appropriato.
Controllo della versione per i dati nella knowledge base
Il controllo della versione per i dati viene fornito tramite le funzionalità di importazione/esportazione nella pagina Impostazioni nel portale di QnA Maker.
È possibile eseguire il backup di una knowledge base esportandola in formato .tsv
o .xls
. Dopo l'esportazione, includere questo file come parte del controllo del codice sorgente standard.
Quando è necessario tornare a una versione specifica, è necessario importare il file dal sistema locale. Una knowledge base esportata deve essere usata solo tramite importazione nella pagina Impostazioni. Non può essere usata come origine dati di tipo file o documento URL. Sostituirà domande e risposte attualmente nella knowledge base con i contenuti del file importato.
Knowledge base di test e produzione
Una Knowledge Base è il repository dei set di domande e risposte creati, gestiti e usati tramite QnA Maker. Ogni risorsa di QnA Maker può contenere più knowledge base.
Una knowledge base ha due stati, test e pubblicata.
Testare la knowledge base
La knowledge base di test è la versione attualmente modificata e salvata. La versione di test è stata testata per verificare l'accuratezza e per la completezza delle risposte. Le modifiche apportate alla knowledge base di test non interessano l'utente finale dell'applicazione o del chatbot. La knowledge base di test è nota come test
nella richiesta HTTP. La knowledge base test
è disponibile con il riquadro Test interattivo di QnA Maker.
Knowledge base di produzione
La knowledge base pubblicata è la versione che viene usata nel chatbot o nell'applicazione. La pubblicazione di una knowledge base inserisce il contenuto della versione di test nella versione pubblicata. La knowledge base pubblicata è la versione usata dall'applicazione tramite l'endpoint. Assicurarsi che il contenuto sia corretto e testato correttamente. La knowledge base pubblicata è nota come prod
nella richiesta HTTP.