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 perguntas sobre a recuperação da chave do 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.

Inclua uma personalidade de bate-papo para tornar suas informações mais interessantes para seus usuários.Include a chit-chat personality to make your knowledge more engaging with your users.

Observação

Os novos recursos criados após 1º de julho de 2019 usarão nomes de subdomínio personalizados.New resources created after July 1, 2019, will use custom subdomain names. Para saber mais e para obter uma lista completa de pontos de extremidade regionais, confira Nomes de subdomínio personalizados para Serviços Cognitivos.For more information and a complete list of regional endpoints, see Custom subdomain names for Cognitive Services.

Pré-requisitoPrerequisite

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

Criar uma base de dados de conhecimento do QnA MakerCreate a new 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.On the QnA Maker portal, select Create a knowledge base.

  3. Na página Criar, selecione Criar um serviço de QnA.On the Create page, 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.

  4. No portal do QnA Maker, selecione o serviço do QnA Maker nas listas suspensas.In the QnA Maker portal, select your QnA Maker service from the drop-down lists. Se você tiver criado um serviço do QnA Maker, não se esqueça de atualizar a página.If you created a new QnA Maker service, be sure to refresh the page.

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

  5. Dê à sua base de dados de conhecimento o nome Minha base de dados de QnA de exemplo.Name your knowledge base My Sample QnA KB.

  6. Adicione um documento do Word de exemplo como uma URL:Add a sample word document as a URL:

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

  7. Selecione + Add URL.Select + Add URL.

  8. Adicione o Bate-Papo Professional à sua KB.Add professional Chit-chat to your KB.

  9. Selecione Criar sua KB.Select Create your KB.

    O processo de extração leva alguns minutos para ler o documento e identificar perguntas e respostas.The extraction process takes a few minutes 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 pergunta e resposta.In the QnA Maker portal, on the Edit page, select Add QnA pair.

  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.Add the question as text and the answer formatted with 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

Na parte superior direito, selecione Salvar e treinar para salvar suas edições e treinar o modelo do QnA Maker.In the upper right, select Save and train to save your edits and train the QnA Maker model. 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.

    How many Azure services are used by a knowledge base?

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

  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

Ao publicar uma base de dados de conhecimento, o conteúdo da base de dados de conhecimento é movido do índice test para um índice prod no Azure Search.When you publish a knowledge base, the contents of your knowledge base moves 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.

    • Não altere as configurações a seguir no portal do Azure ao criar o bot.Don't 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
    • 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.
  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.

Limpar recursosClean up resources

Limpe os recursos do QnA Maker e do Bot Framework no portal do Azure.Clean up the QnA Maker and Bot framework resources in the Azure portal.

Próximas etapasNext steps

Para mais informações:For more information: