Esercitazione: Creare una knowledge base dal portale di QnA MakerTutorial: From the QnA Maker portal, create a knowledge base

Creare una nuova knowledge base con domande e risposte frequenti basate sul Web pubblico.Create a new knowledge base with questions and answers from a public web-based FAQ. Salvare, eseguire il training della knowledge base e pubblicarla.Save, train, and publish the knowledge base. Dopo la pubblicazione della knowledge base, inviare una domanda e ricevere una risposta con un comando cURL.After the knowledge base is published, send a question and receive an answer with a cURL command. Creare quindi un bot e testarlo con la stessa domanda.Then create a bot, and test the bot with the same question.

In questa esercitazione si apprenderà come:In this tutorial, you learn how to:

  • Creare una knowledge base nel portale di QnA Maker.Create a knowledge base in the QnA Maker portal.
  • Esaminare e salvare la knowledge base ed eseguirne il training.Review, save, and train the knowledge base.
  • Pubblicare la knowledge base.Publish the knowledge base.
  • Usare cURL per eseguire query sulla knowledge base.Use cURL to query the knowledge base.
  • Creare un bot.Create a bot.

Nota

La versione programmatica di questa esercitazione è disponibile con una soluzione completa nel repository GitHub Azure-Samples/cognitive-services-qnamaker-csharo.The programmatic version of this tutorial is available with a complete solution from the Azure-Samples/cognitive-services-qnamaker-csharp GitHub repository.

PrerequisitiPrerequisites

Questa esercitazione richiede un servizio QnA Maker esistente.This tutorial requires an existing QnA Maker service.

Creare una knowledge baseCreate a knowledge base

  1. Accedere al portale di QnA Maker.Sign in to the QnA Maker portal.

  2. Selezionare Create a knowledge base (Creare una knowledge base) nel menu in alto.Select Create a knowledge base from the top menu.

    Screenshot del portale di QnA Maker

  3. Ignorare il primo passaggio perché verrà usato il servizio QnA Maker esistente.Skip the first step, because you will use your existing QnA Maker service.

  4. Selezionare le impostazioni esistenti:Select your existing settings:

    ImpostazioneSetting ScopoPurpose
    Microsoft Azure Directory ID (ID directory Microsoft Azure)Microsoft Azure Directory ID Questo ID è associato all'account usato per accedere al portale di Azure e al portale di QnA Maker.This ID is associated with the account you use to sign into the Azure portal and the QnA Maker portal.
    Nome della sottoscrizione di AzureAzure Subscription name Account di fatturazione in cui è stata creata la risorsa QnA Maker.The billing account in which you created the QnA Maker resource.
    Servizio Azure QnAAzure QnA Service Risorsa QnA Maker esistente.Your existing QnA Maker resource.

    Screenshot del portale di QnA Maker

  5. Immettere il nome della knowledge base, My Tutorial kb.Enter your knowledge base name, My Tutorial kb.

    Screenshot del portale di QnA Maker

  6. Popolare la knowledge base con le impostazioni seguenti:Populate your knowledge base with the following settings:

    Nome impostazioneSetting name Valore impostazioneSetting value ScopoPurpose
    URLURL https://docs.microsoft.com/azure/cognitive-services/qnamaker/faqs Il contenuto delle domande frequenti in tale URL viene formattato con una domanda seguita da una risposta.The contents of the FAQ at that URL are formatted with a question followed by an answer. QnA Maker può interpretare questo formato per estrarre le domande e le risposte associate.QnA Maker can interpret this format to extract questions and the associated answers.
    FileFile Non usato in questa esercitazionenot used in this tutorial Consente di caricare i file per le domande e le risposte.This uploads files for questions and answers.
    Personalità Chit-chatChit-chat personality GentileFriendly Dà una personalità amichevole e informale alle domande e risposte comuni.This gives a friendly and casual personality to common questions and answers. È possibile modificare queste domande e risposte in un secondo momento.You can edit these questions and answers later.

    Screenshot del portale di QnA Maker

  7. Selezionare Create your KB (Crea la knowledge base) per completare il processo di creazione.Select Create your KB to finish the creation process.

    Screenshot del portale di QnA Maker

Esaminare, salvare ed eseguire il training della knowledge baseReview, save, and train the knowledge base

  1. Rivedere le domande e le risposte.Review the questions and answers. La prima pagina è costituita da domande e risposte dell'URL.The first page is questions and answers from the URL.

    Screenshot del portale di QnA Maker

  2. Selezionare l'ultima pagina di domande e risposte nella parte inferiore della tabella.Select the last page of questions and answers from the bottom of the table. La pagina mostra le domande e le risposte della personalità Chit-chat.The page shows questions and answers from the Chit-chat personality.

  3. Sulla barra degli strumenti sopra l'elenco di domande e risposte selezionare l'icona View options (Opzioni visualizzazione) e quindi Show metadata (Mostra metadati).From the toolbar above the list of questions and answers, select the View options icon, and then select Show metadata. Vengono visualizzati i tag dei metadati per ogni domanda e risposta.This shows the metadata tags for each question and answer. Per le domande Chit-chat sono già impostati i metadati editorial: chit-chat.The Chit-chat questions have the editorial: chit-chat metadata already set. Questi metadati vengono restituiti all'applicazione client insieme alla risposta selezionata.This metadata is returned to the client application, along with the selected answer. L'applicazione client, ad esempio un chat bot, può usare questi metadati filtrati per determinare altre elaborazioni o interazioni con l'utente.The client application, such as a chat bot, can use this filtered metadata to determine additional processing or interactions with the user.

    Screenshot del portale di QnA Maker

  4. Selezionare Save and train (Salva ed esegui training) nella barra dei menu in alto.Select Save and train in the top menu bar.

Eseguire la pubblicazione per ottenere gli endpoint della knowledge basePublish to get knowledge base endpoints

Selezionare il pulsante Publish (Pubblica) nel menu in alto.Select the Publish button from the top menu. Nella pagina di pubblicazione selezionare Pubblica.On the publish page, select Publish.

Screenshot del portale di QnA Maker

Dopo la pubblicazione della knowledge base viene visualizzato l'endpoint.After the knowledge base is published, the endpoint is displayed.

Screenshot delle impostazioni dell'endpoint

Non chiudere la pagina Publish (Pubblica).Don't close this Publish page. Sarà necessaria più avanti in questa esercitazione per creare un bot.You need it later in the tutorial, to create a bot.

Usare cURL per eseguire una query per una risposta alle domande frequentiUse cURL to query for an FAQ answer

  1. Selezionare la scheda Curl.Select the Curl tab.

    Screenshot della scheda Curl

  2. Copiare il testo della scheda Curl ed eseguirlo in una riga di comando o un terminale abilitato per cURL.Copy the text of the Curl tab, and run it in a cURL-enabled terminal or command-line. Il valore dell'intestazione dell'autorizzazione include il testo Endpoint con uno spazio finale seguito dalla chiave.The authorization header's value includes the text Endpoint, with a trailing space and then the key.

  3. Sostituire <Your question> con How large can my KB be?.Replace <Your question> with How large can my KB be?. Il testo è simile alla domanda, How large a knowledge base can I create?, ma non esattamente uguale.This is close to the question, How large a knowledge base can I create?, but not exactly the same. QnA Maker applica l'elaborazione del linguaggio naturale per determinare che le due domande sono le stesse.QnA Maker applies natural language processing to determine that the two questions are the same.

  4. Eseguire il comando cURL e ricevere la risposta JSON, che include il punteggio e la risposta.Run the cURL command and receive the JSON response, including the score and answer.

      % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                     Dload  Upload   Total   Spent    Left  Speed
    100   581  100   543  100    38    418     29  0:00:01  0:00:01 --:--:--   447{
      "answers": [
        {
          "questions": [
            "How large a knowledge base can I create?"
          ],
          "answer": "The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Read [here](https://docs.microsoft.com/azure/cognitive-services/qnamaker/tutorials/choosing-capacity-qnamaker-deployment)for more details.",
          "score": 42.81,
          "id": 2,
          "source": "https://docs.microsoft.com/azure/cognitive-services/qnamaker/faqs",
          "metadata": []
        }
      ]
    }
    
    

    QnA Maker è abbastanza attendibile con il punteggio di 42,81%.QnA Maker is somewhat confident with the score of 42.81%.

Usare cURL per eseguire una query per una risposta Chit-chatUse cURL to query for a Chit-chat answer

  1. Nel terminale abilitato per cURL sostituire How large can my KB be? con una frase dell'utente del bot di fine conversazione, ad esempio Thank you.In the cURL-enabled terminal, replace How large can my KB be? with a bot conversation-ending statement from the user, such as Thank you.

  2. Eseguire il comando cURL e ricevere la risposta JSON, che include il punteggio e la risposta.Run the cURL command and receive the JSON response, including the score and answer.

      % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                     Dload  Upload   Total   Spent    Left  Speed
    100   525  100   501  100    24    525     25 --:--:-- --:--:-- --:--:--   550{
      "answers": [
        {
          "questions": [
            "Thank you",
            "Thanks",
            "Thnx",
            "Kthx",
            "I appreciate it",
            "Thank you so much",
            "I thank you",
            "My sincere thank"
          ],
          "answer": "You're very welcome.",
          "score": 100.0,
          "id": 109,
          "source": "qna_chitchat_the_friend.tsv",
          "metadata": [
            {
              "name": "editorial",
              "value": "chitchat"
            }
          ]
        }
      ]
    }
    
    

    Poiché la domanda di Thank you corrisponde esattamente a una domanda Chit chat, QnA Maker è assolutamente attendibile con il punteggio di 100.Because the question of Thank you exactly matched a Chit-chat question, QnA Maker is completely confident with the score of 100. QnA Maker ha restituito anche tutte le domande correlate e la proprietà dei metadati contenente le informazioni dei tag di metadati Chit-chat.QnA Maker also returned all the related questions, as well as the metadata property containing the Chit-chat metadata tag information.

Usare cURL per eseguire una query per la risposta predefinitaUse cURL to query for the default answer

A ogni domanda per cui QnA Maker non ottiene un punteggio ritenuto attendibile si riceve la risposta predefinita.Any question that QnA Maker is not confident about receives the default answer. Questa risposta viene configurata nel portale di Azure.This answer is configured in the Azure portal.

  1. Nel terminale abilitato per cURL sostituire Thank you con x.In the cURL-enabled terminal, replace Thank you with x.

  2. Eseguire il comando cURL e ricevere la risposta JSON, che include il punteggio e la risposta.Run the cURL command and receive the JSON response, including the score and answer.

      % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                     Dload  Upload   Total   Spent    Left  Speed
    100   186  100   170  100    16    272     25 --:--:-- --:--:-- --:--:--   297{
      "answers": [
        {
          "questions": [],
          "answer": "No good match found in KB.",
          "score": 0.0,
          "id": -1,
          "metadata": []
        }
      ]
    }
    

    QnA Maker ha restituito il punteggio 0, che indica nessuna attendibilità,QnA Maker returned a score of 0, which means no confidence. nonché la risposta predefinita.It also returned the default answer.

Creare un bot della knowledge baseCreate a knowledge base bot

Per altre informazioni, vedere come creare un chatbot con questa knowledge base.For more information, see Create a chat bot with this knowledge base.

Pulire le risorseClean up resources

Al termine delle operazioni con il bot della knowledge base, rimuovere il gruppo di risorse, my-tutorial-rg, in modo da rimuovere tutte le risorse di Azure create nel processo bot.When you are done with the knowledge base bot, remove the resource group, my-tutorial-rg, to remove all the Azure resources created in the bot process.

Al termine delle operazioni con la knowledge base, nel portale di QnA Maker selezionare My knowledge bases (Knowledge base personali).When you are done with the knowledge base, in the QnA Maker portal, select My knowledge bases. Selezionare quindi la knowledge base My Tutorial kb e l'icona di eliminazione all'estrema destra della riga.Then select the knowledge base, My Tutorial kb, and select the delete icon at the far right in that row.

Passaggi successiviNext steps

Per altre informazioni sui formati di file supportati, vedere Origini dati supportate.See Data sources supported for more information about support file formats.

Altre informazioni sulle personalità Chit-chat.Learn more about Chit-chat personalities.

Per altre informazioni sula risposta predefinita, vedere Nessuna corrispondenza trovata.For more information about the default answer, see No match found.