Tutorial: No portal do QnA Maker, crie uma base de dados de conhecimentoTutorial: From the QnA Maker portal, create a knowledge base

Crie uma base de dados de conhecimento com perguntas e respostas de perguntas frequentes públicas baseadas na Web.Create a new knowledge base with questions and answers from a public web-based FAQ. Salve, treine e publique a base de dados de conhecimento.Save, train, and publish the knowledge base. Depois que a base de dados de conhecimento for publicada, envie uma pergunta e receba uma resposta com um comando do cURL.After the knowledge base is published, send a question and receive an answer with a cURL command. Em seguida, crie um bot e teste-o com a mesma pergunta.Then create a bot, and test the bot with the same question.

Neste tutorial, você aprenderá como:In this tutorial, you learn how to:

  • Criar uma base de dados de conhecimento no portal do QnA Maker.Create a knowledge base in the QnA Maker portal.
  • Examinar, salvar e treinar a base de dados de conhecimento.Review, save, and train the knowledge base.
  • Publicar a base de dados de conhecimento.Publish the knowledge base.
  • Usar cURL para consultar a base de dados de conhecimento.Use cURL to query the knowledge base.
  • Criar um bot.Create a bot.

Observação

A versão programática deste tutorial está disponível com uma solução completa Azure-Samples/cognitive-services-qnamaker-csharp no repositório do GitHub.The programmatic version of this tutorial is available with a complete solution from the Azure-Samples/cognitive-services-qnamaker-csharp GitHub repository.

Pré-requisitosPrerequisites

Este tutorial requer um serviço QnA Maker existente.This tutorial requires an existing QnA Maker service.

Como criar uma base de dados de conhecimentoCreate a knowledge base

  1. Entre no portal do QnA Maker.Sign in to the QnA Maker portal.

  2. Selecione Criar uma base de dados de conhecimento no menu superior.Select Create a knowledge base from the top menu.

    Captura de tela do portal do QnA Maker

  3. Ignore a primeira etapa, porque você usará seu serviço do QnA Maker existente.Skip the first step, because you will use your existing QnA Maker service.

  4. Selecione suas configurações existentes:Select your existing settings:

    ConfiguraçãoSetting FinalidadePurpose
    ID do Diretório do Microsoft AzureMicrosoft Azure Directory ID Essa ID está associada à conta que você usa para entrar no portal do Azure e no portal do QnA Maker.This ID is associated with the account you use to sign into the Azure portal and the QnA Maker portal.
    Nome da assinatura do AzureAzure Subscription name A conta de cobrança na qual você criou o recurso do QnA Maker.The billing account in which you created the QnA Maker resource.
    Serviço QnA do AzureAzure QnA Service O recurso existente do QnA Maker.Your existing QnA Maker resource.

    Captura de tela do portal do QnA Maker

  5. Insira o nome da sua base de dados de conhecimento, My Tutorial kb.Enter your knowledge base name, My Tutorial kb.

    Captura de tela do portal do QnA Maker

  6. Popule sua base de dados de conhecimento com as seguintes configurações:Populate your knowledge base with the following settings:

    Nome da configuraçãoSetting name Valor da configuraçãoSetting value FinalidadePurpose
    URLURL https://docs.microsoft.com/azure/cognitive-services/qnamaker/faqs O conteúdo das Perguntas frequentes nessa URL é formatado com um ponto de interrogação seguido de uma resposta.The contents of the FAQ at that URL are formatted with a question followed by an answer. O QnA Maker pode interpretar esse formato para extrair perguntas e as respostas associadas.QnA Maker can interpret this format to extract questions and the associated answers.
    ArquivoFile não usado neste tutorialnot used in this tutorial Isso carrega arquivos para perguntas e respostas.This uploads files for questions and answers.
    Personalidade do bate-papoChit-chat personality AmigávelFriendly Isso oferece uma personalidade casual e amigável para perguntas e respostas comuns.This gives a friendly and casual personality to common questions and answers. Você pode editar essas perguntas e respostas mais tarde.You can edit these questions and answers later.

    Captura de tela do portal do QnA Maker

  7. Selecione Criar sua KB para concluir o processo de criação.Select Create your KB to finish the creation process.

    Captura de tela do portal do QnA Maker

Revisar, salvar e treinar a base de dados de conhecimentoReview, save, and train the knowledge base

  1. Examine as perguntas e respostas.Review the questions and answers. A primeira página é de perguntas e respostas da URL.The first page is questions and answers from the URL.

    Captura de tela do portal do QnA Maker

  2. Selecione a última página de perguntas e respostas na parte inferior da tabela.Select the last page of questions and answers from the bottom of the table. A página mostra as perguntas e respostas da Personalidade do bate-papo.The page shows questions and answers from the Chit-chat personality.

  3. Na barra de ferramentas acima da lista de perguntas e respostas, selecione o ícone Opções de exibição e, em seguida, Mostrar metadados.From the toolbar above the list of questions and answers, select the View options icon, and then select Show metadata. Isso mostra as marcas de metadados para cada pergunta e resposta.This shows the metadata tags for each question and answer. As perguntas de bate-papo têm os metadados editorial: bate-papo já definidos.The Chit-chat questions have the editorial: chit-chat metadata already set. Esses metadados são retornados ao aplicativo cliente, juntamente com a resposta selecionada.This metadata is returned to the client application, along with the selected answer. O aplicativo cliente, como um chatbot, pode usar esses metadados filtrados para determinar outros processamentos ou interações com o usuário.The client application, such as a chat bot, can use this filtered metadata to determine additional processing or interactions with the user.

    Captura de tela do portal do QnA Maker

  4. Selecione Salvar e treinar na barra de menus superior.Select Save and train in the top menu bar.

Publicar para obter pontos de extremidade da base de dados de conhecimentoPublish to get knowledge base endpoints

Selecione o botão Publicar no menu superior.Select the Publish button from the top menu. Na página de publicação, selecione Publicar.On the publish page, select Publish.

Captura de tela do portal do QnA Maker

Depois que a base de dados de conhecimento for publicada, o ponto de extremidade será exibido.After the knowledge base is published, the endpoint is displayed.

Captura de tela das configurações do ponto de extremidade

Não feche esta página Publicar.Don't close this Publish page. Você precisará dela posteriormente neste tutorial para criar um bot.You need it later in the tutorial, to create a bot.

Usar o cURL para consultar uma resposta de perguntas frequentesUse cURL to query for an FAQ answer

  1. Selecione a guia cURL.Select the Curl tab.

    Captura de tela da guia Curl

  2. Copie o texto da guia Curl e execute-o em um terminal ou linha de comando habilitado para cURL.Copy the text of the Curl tab, and run it in a cURL-enabled terminal or command-line. O valor do cabeçalho de autorização inclui o texto Endpoint com um espaço à direita e, em seguida, a chave.The authorization header's value includes the text Endpoint, with a trailing space and then the key.

  3. Substitua <Your question> por How large can my KB be?.Replace <Your question> with How large can my KB be?. Isso parece a pergunta How large a knowledge base can I create?, mas não exatamente.This is close to the question, How large a knowledge base can I create?, but not exactly the same. O QnA Maker aplica processamento de linguagem natural para determinar se as duas perguntas são iguais.QnA Maker applies natural language processing to determine that the two questions are the same.

  4. Execute o comando do cURL e receba a resposta JSON, incluindo a pontuação e a resposta.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": []
        }
      ]
    }
    
    

    O QnA Maker tem alguma certeza, com pontuação de 42,81%.QnA Maker is somewhat confident with the score of 42.81%.

Usar o cURL para consultar uma resposta de bate-papoUse cURL to query for a Chit-chat answer

  1. No terminal habilitado para o cURL, substitua How large can my KB be? por uma instrução de fim de conversa do bot feita pelo usuário, como 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. Execute o comando do cURL e receba a resposta JSON, incluindo a pontuação e a resposta.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"
            }
          ]
        }
      ]
    }
    
    

    Como a pergunta Thank you correspondeu exatamente a uma pergunta do bate-papo, o QnA Maker está completamente seguro com a pontuação de 100.Because the question of Thank you exactly matched a Chit-chat question, QnA Maker is completely confident with the score of 100. O QnA Maker também retornou todas as perguntas relacionadas e a propriedade de metadados que contém as informações de marca de metadados de Bate-papo.QnA Maker also returned all the related questions, as well as the metadata property containing the Chit-chat metadata tag information.

Usar o cURL para consultar a resposta padrãoUse cURL to query for the default answer

Todas as perguntas que não tenham grau de confiança do QnA Maker recebem a resposta padrão.Any question that QnA Maker is not confident about receives the default answer. Esta resposta é configurada no portal do Azure.This answer is configured in the Azure portal.

  1. No terminal habilitado para cURL, substitua Thank you por x.In the cURL-enabled terminal, replace Thank you with x.

  2. Execute o comando do cURL e receba a resposta JSON, incluindo a pontuação e a resposta.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": []
        }
      ]
    }
    

    O QnA Maker retornou uma pontuação igual a 0, o que significa nenhuma confiança.QnA Maker returned a score of 0, which means no confidence. Ele também retornou uma resposta padrão.It also returned the default answer.

Criar um bot da base de dados de conhecimentoCreate a knowledge base bot

Para obter mais informações, confira Criar um chatbot com esta base de dados de conhecimento.For more information, see Create a chat bot with this knowledge base.

Limpar recursosClean up resources

Quando terminar de trabalhar com o bot da base de dados de conhecimento, remova o grupo de recursos, my-tutorial-rg, para remover todos os recursos do Azure criados no processo do 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.

Quando terminar de usar a base de dados de conhecimento, no portal do QnA Maker, selecione Minhas bases de dados de conhecimento.When you are done with the knowledge base, in the QnA Maker portal, select My knowledge bases. Em seguida, selecione a base de dados de conhecimento Minha KB de tutorial e selecione o ícone Excluir na extremidade direita da linha.Then select the knowledge base, My Tutorial kb, and select the delete icon at the far right in that row.

Próximas etapasNext steps

Consulte as Fontes de dados com suporte para obter mais informações sobre os formatos de arquivo com suporte.See Data sources supported for more information about support file formats.

Saiba mais sobre personalidades de bate-papo.Learn more about Chit-chat personalities.

Para obter mais informações sobre a resposta padrão, consulte Nenhuma correspondência encontrada.For more information about the default answer, see No match found.