Guida introduttiva: creare, eseguire il training e pubblicare la QnA Maker Knowledge baseQuickstart: 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 alle domande di QnA Maker.This article includes an example of creating a QnA Maker knowledge base from a simple FAQ webpage, to answer questions QnA Maker.

PrerequisitiPrerequisites

  • 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.
  • Una risorsa QnA Maker creata nel portale di Azure.A QnA Maker resource created in the Azure portal. Prendere nota dei valori di ID di Azure Active Directory, sottoscrizione e nome della risorsa di QnA selezionati durante la creazione della risorsa.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

Creare la prima knowledge base di QnA MakerCreate your first 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.In the QnA Maker portal, select Create a knowledge base.

  3. Nella pagina Crea ignorare il Passaggio 1 se la risorsa QnA Maker è già presente.On the Create page, skip Step 1 if you already have your QnA Maker resource.

    Se la risorsa non è ancora stata creata, selezionare Creare un servizio QnA.If you haven't created the resource yet, 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. Prendere nota dei valori di ID di Azure Active Directory, sottoscrizione e nome della risorsa di QnA selezionati durante la creazione della risorsa.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

    Al termine della creazione della risorsa nel portale di Azure, tornare al portale di QnA Maker, aggiornare la pagina del browser e continuare con il Passaggio 2.When you are done creating the resource in the Azure portal, return to the QnA Maker portal, refresh the browser page, and continue to Step 2.

  4. Nel Passaggio 3 selezionare l'istanza di Active Directory, la sottoscrizione, il servizio (risorsa) e la lingua per tutte le knowledge base create nel servizio.In Step 3, select your Active directory, subscription, service (resource), and the language for all knowledge bases created in the service.

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

  5. Nel Passaggio 3 assegnare alla knowledge base il nome My Sample QnA KB.In Step 3, name your knowledge base My Sample QnA KB.

  6. Nel Passaggio 4 configurare le impostazioni in base alla tabella seguente:In Step 4, configure the settings with the following table:

    ImpostazioneSetting valoreValue
    Enable multi-turn extraction from URLs, .pdf or .docx files (Abilita estrazione a più turni da URL e file PDF o DOCX)Enable multi-turn extraction from URLs, .pdf or .docx files. SelezionatoChecked
    Default answer text (Testo della risposta predefinita)Default answer text Quickstart - default answer not found.
    + Add URL (+ Aggiungi URL)+ Add URL https://docs.microsoft.com/azure/cognitive-services/qnamaker/troubleshooting
    Chit-chatChit-chat Selezionare ProfessionalSelect Professional
  7. Nel passaggio 5selezionare Crea la KB.In Step 5, 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 moments 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) sulla barra degli strumenti contestuale.In the QnA Maker portal, on the Edit page, select + Add QnA pair from the context toolbar.

  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.

    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 di QnA Maker.In the upper right, select Save and train to save your edits and train QnA Maker . 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.

  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

Creare 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. 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.

    • FareDo
      • Cambiare l'handle del bot, se non è univoco.Change bot handle - if it is not unique.
      • Selezionare il linguaggio dell'SDK.Select SDK Language. Una volta creato il bot, è possibile scaricare il codice nell'ambiente di sviluppo locale e continuare il processo di sviluppo.Once the bot is created, you can download the code to your local development environment and continue the development process.
    • Cosa non fareDon't
      • Cambiare le impostazioni seguenti nel portale di Azure quando si crea il bot.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
  3. Dopo aver creato il bot, aprire la risorsa servizio Bot.After the bot is created, open the Bot service resource.

  4. In bot Managementselezionare test in web chat.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.

Cosa si è ottenuto?What did you accomplish?

È stata creata una nuova Knowledge base, è stato aggiunto un URL pubblico alla Knowledge base, è stata aggiunta la propria coppia QnA, sottoposta a training, testato e pubblicata la Knowledge base.You created a new knowledge base, added a public URL to the knowledge base, added your own QnA pair, trained, tested, and published the knowledge base.

Dopo aver pubblicato la knowledge base, è stato creato un bot, che è stato testato.After publishing the knowledge base, you created a bot, and tested the bot.

Questa procedura è stata completata in pochi minuti senza la necessità di scrivere codice o pulire il contenuto.This was all accomplished in a few minutes without having to write any code or clean the content.

Pulire le risorseClean up resources

Se non si continua con l'argomento di avvio rapido successivo, eliminare le risorse QnA Maker e Bot Framework nel portale di Azure.If you are not continuing to the next quickstart, delete the QnA Maker and Bot framework resources in the Azure portal.

Passaggi successiviNext steps

Per altre informazioni:For more information: