Início Rápido: Criar, treinar e publicar sua base de dados de conhecimento do QnA MakerQuickstart: Create, train, and publish your QnA Maker knowledge base

É possível criar uma KB (base de dados de conhecimento) do QnA Maker com base no seu próprio conteúdo, como perguntas frequentes ou manuais de produto.You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. Este artigo inclui um exemplo de como criar uma base de dados de conhecimento do QnA Maker com base em uma página da Web simples de perguntas frequentes para responder a perguntas sobre o QnA Maker.This article includes an example of creating a QnA Maker knowledge base from a simple FAQ webpage, to answer questions QnA Maker.

Pré-requisitosPrerequisites

  • Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.
  • Um recurso do QnA Maker criado no portal do Azure.A QnA Maker resource created in the Azure portal. Lembre-se de sua ID e sua assinatura do Azure Active Directory, bem como do nome do recurso do QnA que você selecionou ao criar o recurso.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

Criar sua primeira base de dados de conhecimento do QnA MakerCreate your first QnA Maker knowledge base

  1. Entre no portal QnAMaker.ai com suas credenciais do Azure.Sign in to the QnAMaker.ai portal with your Azure credentials.

  2. No portal do QnA Maker, selecione Criar uma base de dados de conhecimento.In the QnA Maker portal, select Create a knowledge base.

  3. Na página Criar, pule a Etapa 1 caso já tenha o recurso do QnA Maker.On the Create page, skip Step 1 if you already have your QnA Maker resource.

    Se você ainda não criou o recurso, selecione Criar um serviço do QnA.If you haven't created the resource yet, select Create a QnA service. Você será direcionado para o portal do Azure para configurar o serviço do QnA Maker na sua assinatura.You are directed to the Azure portal to set up a QnA Maker service in your subscription. Lembre-se de sua ID e sua assinatura do Azure Active Directory, bem como do nome do recurso do QnA que você selecionou ao criar o recurso.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

    Quando terminar de criar o recurso no portal do Azure, retorne ao portal do QnA Maker, atualize a página do navegador e prossiga para a Etapa 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. Na Etapa 2, selecione o serviço (recurso), o idioma e a assinatura do Active Directory para todas as bases de dados de conhecimento criadas no serviço.In Step 2, select your Active directory, subscription, service (resource), and the language for all knowledge bases created in the service.

    Captura de tela da seleção de uma base de dados de conhecimento do serviço do QnA Maker

  5. Na Etapa 3, dê à base de dados de conhecimento o nome Minha Base de Dados de QnA de Exemplo.In Step 3, name your knowledge base My Sample QnA KB.

  6. Na Etapa 4, defina as configurações com a seguinte tabela:In Step 4, configure the settings with the following table:

    ConfiguraçãoSetting ValorValue
    Habilitar a extração de vários turnos de URLs, arquivos .pdf ou .docx.Enable multi-turn extraction from URLs, .pdf or .docx files. VerificadoChecked
    Texto padrão com várias seçõesMulti-turn default text Selecionar uma opçãoSelect and option
    + Adicionar URL+ Add URL https://www.microsoft.com/en-us/software-download/faq
    Bate-papoChit-chat Selecione ProfessionalSelect Professional
  7. Na Etapa 5, selecione Criar sua base de dados.In Step 5, Select Create your KB.

    O processo de extração leva alguns instantes para ler o documento e identificar perguntas e respostas.The extraction process takes a few moments to read the document and identify questions and answers.

    Depois que o QnA Maker criar com êxito a base de dados de conhecimento, a página Base de dados de conhecimento será aberta.After QnA Maker successfully creates the knowledge base, the Knowledge base page opens. Você pode editar o conteúdo da base de dados de conhecimento nesta página.You can edit the contents of the knowledge base on this page.

Adicionar um novo par de pergunta e respostaAdd a new question and answer set

  1. No portal do QnA Maker, na página Editar, selecione + Adicionar par de P e R na barra de ferramentas de contexto.In the QnA Maker portal, on the Edit page, select + Add QnA pair from the context toolbar.

  2. Adicione a seguinte pergunta:Add the following question:

    How many Azure services are used by a knowledge base?

  3. Adicione a resposta formatada com Markdown:Add the answer formatted with markdown:

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

    Adicione a pergunta como texto e a resposta formatada com Markdown.

    O símbolo de Markdown, *, é usado para marcadores.The markdown symbol, *, is used for bullet points. O \n é usado para uma nova linha.The \n is used for a new line.

    A página Editar mostra o Markdown.The Edit page shows the markdown. Quando você usar o painel Testar posteriormente, verá o Markdown exibido corretamente.When you use the Test panel later, you will see the markdown displayed properly.

Salvar e treinarSave and train

No canto superior direito, selecione Salvar e treinar para salvar as edições e treinar o QnA Maker.In the upper right, select Save and train to save your edits and train QnA Maker. As edições não serão mantidas se não forem salvas.Edits aren't kept unless they're saved.

Testar a base de dados de conhecimentoTest the knowledge base

  1. No portal do QnA Maker, selecione Testar para verificar se as alterações entraram em vigor.In the QnA Maker portal, in the upper right, select Test to test that the changes you made took effect.

  2. Insira um exemplo de consulta de usuário na caixa de texto.Enter an example user query in the textbox.

    I want to know the difference between 32 bit and 64 bit Windows

    Insira um exemplo de consulta de usuário na caixa de texto.

  3. Selecione Inspecionar para examinar a resposta mais detalhadamente.Select Inspect to examine the response in more detail. A janela de teste é usada para testar as alterações na base de dados de conhecimento antes que ela seja publicada.The test window is used to test your changes to the knowledge base before publishing your knowledge base.

  4. Selecione Testar novamente para fechar o painel Testar.Select Test again to close the Test panel.

Publicar a base de dados de conhecimentoPublish the knowledge base

Quando você publica uma base de dados de conhecimento, o conteúdo dela é movido do índice test para um índice prod no Azure Search.When you publish a knowledge base, the contents of your knowledge base move from the test index to a prod index in Azure search.

Captura de tela da movimentação do conteúdo de sua base de dados de conhecimento

  1. No portal do QnA Maker, selecione Publicar.In the QnA Maker portal, select Publish. Para confirmar, selecione Publicar na página.Then to confirm, select Publish on the page.

    O serviço do QnA Maker foi publicado com êxito.The QnA Maker service is now successfully published. É possível usar o ponto de extremidade no aplicativo ou código de bot.You can use the endpoint in your application or bot code.

    Captura de tela da publicação bem-sucedida

Criar um botCreate a bot

Após a publicação, é possível criar um bot na página Publicar:After publishing, you can create a bot from the Publish page:

  • Você pode criar vários bots rapidamente, todos apontando para a mesma base de dados conhecimento para diferentes regiões ou planos de preço para os bots individuais.You can create several bots quickly, all pointing to the same knowledge base for different regions or pricing plans for the individual bots.
  • Se você quiser apenas um bot para a base de dados de conhecimento, use o link Exibir todos os bots no portal do Azure para exibir uma lista de seus bots atuais.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 você faz alterações na base de dados de conhecimento e republica, não é necessário fazer mais nada com o bot.When you make changes to the knowledge base and republish, you don't need to take further action with the bot. Ele já está configurado para trabalhar com a base de dados de conhecimento e trabalha com todas as alterações futuras na base de dados de conhecimento.It's already configured to work with the knowledge base, and works with all future changes to the knowledge base. Sempre que você publica uma base de dados de conhecimento, todos os bots conectados a ela são atualizados automaticamente.Every time you publish a knowledge base, all the bots connected to it are automatically updated.

  1. No portal do QnA Maker, na página Publicar, selecione Criar bot.In the QnA Maker portal, on the Publish page, select Create bot. Esse botão será exibido somente depois que você tiver publicado a base de dados de conhecimento.This button appears only after you've published the knowledge base.

    Captura de tela da criação de um bot

  2. É aberta uma nova guia do navegador para o portal do Azure com a página de criação do Serviço de Bot do Azure.A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Configure o serviço de bot do Azure.Configure the Azure bot service. O bot e o QnA Maker podem compartilhar o plano do serviço de aplicativo Web, mas não podem compartilhar o aplicativo Web.The bot and QnA Maker can share the web app service plan, but can't share the web app. Isso significa que o nome do aplicativo para o bot deve ser diferente do nome do aplicativo usado para o serviço do QnA Maker.This means the app name for the bot must be different from the app name for the QnA Maker service.

    • Deve ser feitoDo
      • Alterar o identificador de bot se ele não for exclusivo.Change bot handle - if it is not unique.
      • Selecionar a linguagem de programação do SDK.Select SDK Language. Depois que o bot for criado, você poderá baixar o código em seu ambiente de desenvolvimento local e continuar o processo de desenvolvimento.Once the bot is created, you can download the code to your local development environment and continue the development process.
    • O que não fazerDon't
      • Alterar as configurações a seguir no portal do Azure ao criar o bot.change the following settings in the Azure portal when creating the bot. Elas são preenchidas previamente para sua base de dados de conhecimento existente:They are pre-populated for your existing knowledge base:
        • Chave de autenticação do QnAQnA Auth Key
        • Plano e local do serviço de aplicativoApp service plan and location
  3. Depois que o bot for criado, abra o recurso Serviço de bot.After the bot is created, open the Bot service resource.

  4. Em Gerenciamento de Bot, selecione Testar no Webchat.Under Bot Management, select Test in Web Chat.

  5. No prompt de chat de Digite sua mensagem, digite:At the chat prompt of Type your message, enter:

    Azure services?

    O chatbot responde com uma resposta de sua base de dados de conhecimento.The chat bot responds with an answer from your knowledge base.

    Insira uma consulta de usuário no Webchat de teste.

O que você realizou?What did you accomplish?

Você criou uma base de dados de conhecimento, adicionou uma URL pública a ela, adicionou seu par de pergunta e resposta, além de treinar, testar e publicar a base de dados de conhecimento.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.

Depois de publicar a base de dados de conhecimento, você criou e testou um bot.After publishing the knowledge base, you created a bot, and tested the bot.

Isso tudo foi feito em alguns minutos, sem a necessidade de escrever nenhum código nem de limpar o conteúdo.This was all accomplished in a few minutes without having to write any code or clean the content.

Limpar os recursosClean up resources

Se você não for prosseguir para o próximo início rápido, exclua os recursos do QnA Maker e do Bot Framework no portal do Azure.If you are not continuing to the next quickstart, delete the QnA Maker and Bot framework resources in the Azure portal.

Próximas etapasNext steps

Para mais informações:For more information: