Guida introduttiva: Creare, eseguire il training e pubblicare la knowledge base QnA MakerQuickstart: Create, train, and publish your QnA Maker knowledge base

È possibile creare una knowledge base di QnA Maker (KB) a partire dal proprio contenuto, come le domande frequenti o i manuali del prodotto.You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. Questo articolo offre un esempio della creazione di una knowledge base di QnA Maker da una semplice pagina Web di domande frequenti, per rispondere a domande sul recupero delle chiavi di BitLocker.This article includes an example of creating a QnA Maker knowledge base from a simple FAQ webpage, to answer questions on BitLocker key recovery.

Includere una personalità per chit chat in modo da rendere la propria knowledge base più accattivante per gli utenti.Include a chit-chat personality to make your knowledge more engaging with your users.

Nota

Le nuove risorse create dopo il 1° luglio 2019 useranno nomi di sottodomini personalizzati.New resources created after July 1, 2019, will use custom subdomain names. Per altre informazioni e per un elenco completo degli endpoint a livello di area, vedere Nomi di sottodomini personalizzati per Servizi cognitivi.For more information and a complete list of regional endpoints, see Custom subdomain names for Cognitive Services.

PrerequisitoPrerequisite

  • Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Creare una nuova knowledge base di QnA MakerCreate a new QnA Maker knowledge base

  1. Accedere al portale QnAMaker.ai con le credenziali di Azure.Sign in to the QnAMaker.ai portal with your Azure credentials.

  2. Nel portale di QnA Maker, selezionare Creare una knowledge base.On the QnA Maker portal, select Create a knowledge base.

  3. Nella pagina Create (Crea) selezionare Create a QnA service (Crea un servizio QnA).On the Create page, select Create a QnA service. Si verrà reindirizzati al portale di Azure per configurare un servizio QnA Maker nella sottoscrizione.You are directed to the Azure portal to set up a QnA Maker service in your subscription.

  4. Nel portale di QnA Maker selezionare il servizio QnA Maker negli elenchi a discesa.In the QnA Maker portal, select your QnA Maker service from the drop-down lists. Se è stato creato un nuovo servizio QnA Maker, assicurarsi di aggiornare la pagina.If you created a new QnA Maker service, be sure to refresh the page.

    Screenshot della selezione di una knowledge base per il servizio QnA Maker

  5. Assegnare alla knowledge base il nome My Sample QnA KB.Name your knowledge base My Sample QnA KB.

  6. Aggiungere un documento di Word di esempio come URL:Add a sample word document as a URL:

    https://docs.microsoft.com/azure/cognitive-services/qnamaker/troubleshooting

  7. Selezionare + Add URL.Select + Add URL.

  8. Aggiungere chiacchiere professionali alla knowledge base.Add professional Chit-chat to your KB.

  9. Selezionare Crea la KB.Select Create your KB.

    Il processo di estrazione impiega alcuni minuti per leggere il documento e identificare le domande e risposte.The extraction process takes a few minutes to read the document and identify questions and answers.

    Al termine della creazione della knowledge base, verrà visualizzata la pagina Knowledge base.After QnA Maker successfully creates the knowledge base, the Knowledge base page opens. È possibile modificare il contenuto della knowledge base in questa pagina.You can edit the contents of the knowledge base on this page.

Aggiungere un nuovo set di domande e risposteAdd a new question and answer set

  1. Nella pagina Edit (Modifica) del portale di QnA Maker selezionare Add QnA pair (Aggiungi coppia domanda/risposta).In the QnA Maker portal, on the Edit page, select Add QnA pair.

  2. Aggiungere la domanda seguente:Add the following question:

    How many Azure services are used by a knowledge base?

  3. Aggiungere la risposta formattata con Markdown:Add the answer formatted with markdown:

    * Azure QnA Maker service\n* Azure Cognitive Search\n* Azure web app\n* Azure app plan

     Aggiungere la domanda come testo e la risposta formattata con Markdown.Add the question as text and the answer formatted with markdown.

    Il simbolo di markdown, *, viene usato per i punti elenco.The markdown symbol, *, is used for bullet points. \n viene usato per una nuova riga.The \n is used for a new line.

    La pagina Edit (Modifica) mostra il markdown.The Edit page shows the markdown. Quando successivamente si userà il pannello Test, si vedrà il markdown visualizzato correttamente.When you use the Test panel later, you will see the markdown displayed properly.

Save and train (Salva ed esegui training)Save and train

In alto a destra, selezionare Save and train (Salva ed esegui il training) per salvare le modifiche e il training del modello di QnA Maker.In the upper right, select Save and train to save your edits and train the QnA Maker model. Le modifiche non vengono mantenute a meno che non vengano salvate.Edits aren't kept unless they're saved.

Testare la knowledge baseTest the knowledge base

  1. In alto a destra del portale QnA Maker, selezionare Esegui test per verificare che le modifiche apportate abbiano avuto effetto.In the QnA Maker portal, in the upper right, select Test to test that the changes you made took effect.

  2. Immettere una query utente di esempio nella casella di testo.Enter an example user query in the textbox.

    How many Azure services are used by a knowledge base?

     Immettere una query utente di esempio nella casella di testo.Enter an example user query in the textbox.

  3. Selezionare Ispeziona per esaminare la risposta in modo più dettagliato.Select Inspect to examine the response in more detail. La finestra di test viene usata per testare le modifiche alla knowledge base prima della pubblicazione.The test window is used to test your changes to the knowledge base before publishing your knowledge base.

  4. Selezionare nuovamente Test per chiudere il pannello Test.Select Test again to close the Test panel.

Pubblicare la knowledge basePublish the knowledge base

Quando si pubblica una knowledge base, il suo contenuto viene spostato dall'indice test a un indice prod in Ricerca di Azure.When you publish a knowledge base, the contents of your knowledge base moves from the test index to a prod index in Azure search.

Screenshot dello spostamento del contenuto della knowledge base

  1. Nel portale di QnA Maker selezionare Publish (Pubblica).In the QnA Maker portal, select Publish. Quindi, per confermare, selezionare Pubblica nella pagina.Then to confirm, select Publish on the page.

    Il servizio QnA Maker viene pubblicato correttamente.The QnA Maker service is now successfully published. Utilizza l'endpoint nell’applicazione o nel codice bot.You can use the endpoint in your application or bot code.

    Screenshot del completamento della pubblicazione

Creazione di un botCreate a bot

Dopo la pubblicazione è possibile creare un bot dalla pagina Publish (Pubblica):After publishing, you can create a bot from the Publish page:

  • È possibile creare rapidamente diversi bot, che indirzzano tutti alla stessa knowledge base per aree o piani tariffari differenti per i singoli bot.You can create several bots quickly, all pointing to the same knowledge base for different regions or pricing plans for the individual bots.
  • Se si vuole solo un bot per la knowledge base, usare il collegamento View all your bots on the Azure portal (Visualizza tutti i bot nel portale di Azure) per visualizzare un elenco dei bot correnti.If you want only one bot for the knowledge base, use the View all your bots on the Azure portal link to view a list of your current bots.

Quando si apportano modifiche alla knowledge base e si ripete la pubblicazione, non sono necessarie ulteriori azioni con il bot.When you make changes to the knowledge base and republish, you don't need to take further action with the bot. È già configurato per interagire con la knowledge base e funziona con tutte le successive modifiche a essa apportate.It's already configured to work with the knowledge base, and works with all future changes to the knowledge base. Ogni volta che si pubblica una knowledge base, tutti i bot connessi vengono aggiornati automaticamente.Every time you publish a knowledge base, all the bots connected to it are automatically updated.

  1. Nella pagina Pubblicazione del portale di QnA Maker, selezionare Creare il bot.In the QnA Maker portal, on the Publish page, select Create bot. Questo pulsante viene visualizzato solo dopo la pubblicazione della knowledge base.This button appears only after you've published the knowledge base.

    Schermata della creazione di un bot

  2. Viene visualizzata una nuova scheda del browser per il portale di Azure, con la pagina di creazione del servizio Azure Bot.A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Configurare il servizio Azure Bot.Configure the Azure bot service.

    • Durante la creazione del bot non modificare le impostazioni seguenti nel portale di Azure.Don't change the following settings in the Azure portal when creating the bot. Sono già popolate per la knowledge base esistente:They are pre-populated for your existing knowledge base:
      • Chiave di autenticazione QnAQnA Auth Key
      • Piano di servizio app e localitàApp service plan and location
    • Il bot e QnA Maker possono condividere il piano di servizio dell'app Web, ma non l'app Web.The bot and QnA Maker can share the web app service plan, but can't share the web app. Ciò significa che il nome app del bot deve essere diverso da quello del servizio QnA Maker.This means the app name for the bot must be different from the app name for the QnA Maker service.
  3. Dopo aver creato il bot, aprire la risorsa servizio Bot.After the bot is created, open the Bot service resource.

  4. In Bot Management (Gestione bot) selezionare Test in Web Chat (Testa nella chat Web).Under Bot Management, select Test in Web Chat.

  5. Quando viene visualizzato il prompt della chat Type your message (Digitare il messaggio), immettere:At the chat prompt of Type your message, enter:

    Azure services?

    Il chatbot risponde con una risposta della knowledge base.The chat bot responds with an answer from your knowledge base.

    Immettere una query utente nella chat Web di test.

Pulire le risorseClean up resources

Pulire le risorse di QnA Maker e Bot Framework nel portale di Azure.Clean up the QnA Maker and Bot framework resources in the Azure portal.

Passaggi successiviNext steps

Per altre informazioni:For more information: