Quickstart: Criar, treinar e publicar a sua base de conhecimento qnA MakerQuickstart: Create, train, and publish your QnA Maker knowledge base

Pode criar uma Base de Dados de Conhecimento do Criador de FAQ a partir dos seus próprios conteúdos, como as FAQ ou os manuais de produtos.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 criação de uma base de conhecimento qnA Maker a partir de uma simples página web de FAQ, para responder a perguntas 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 não tiver uma subscrição 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 QnA Maker criado no portal Azure.A QnA Maker resource created in the Azure portal. Lembre-se do id do Diretório Ativo Azure, Subscrição, nome de recurso QnA que selecionou quando criou o recurso.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

Crie a sua primeira base de conhecimento qnA MakerCreate your first QnA Maker knowledge base

  1. Inscreva-se no portal QnAMaker.ai com as suas credenciais Azure.Sign in to the QnAMaker.ai portal with your Azure credentials.

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

  3. Na página Criar, salte o Passo 1 se já tiver o seu recurso QnA Maker.On the Create page, skip Step 1 if you already have your QnA Maker resource.

    Se ainda não criou o recurso, selecione Criar um serviço QnA.If you haven't created the resource yet, select Create a QnA service. Será direcionado para o portal do Azure para configurar um serviço do Criador de FAQ na sua subscrição.You are directed to the Azure portal to set up a QnA Maker service in your subscription. Lembre-se do id do Diretório Ativo Azure, Subscrição, nome de recurso QnA que selecionou quando criou 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 Azure, volte ao portal QnA Maker, refresque a página do navegador e continue a passo 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. No Passo 3, selecione o seu diretório Ativo, subscrição, serviço (recurso) e o idioma para todas as bases de conhecimento criadas no serviço.In Step 3, select your Active directory, subscription, service (resource), and the language for all knowledge bases created in the service.

    Screenshot de selecionar uma base de conhecimento de serviço QnA Maker

  5. No passo 3, nomeie a sua base de conhecimentos My Sample QnA KB.In Step 3, name your knowledge base My Sample QnA KB.

  6. No passo 4, configure as definições com a tabela seguinte:In Step 4, configure the settings with the following table:

    DefiniçãoSetting ValorValue
    Ativar a extração de várias voltas a partir de URLs, ficheiros .pdf ou .docx.Enable multi-turn extraction from URLs, .pdf or .docx files. AssinaladoChecked
    Texto de resposta padrãoDefault answer text Quickstart - default answer not found.
    + Adicionar URL+ Add URL https://docs.microsoft.com/azure/cognitive-services/qnamaker/troubleshooting
    Chit-chatChit-chat Selecionar ProfissionalSelect Professional
  7. No passo 5, selecione Criar o seu KB.In Step 5, Select Create your KB.

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

    Depois da QnA Maker criar com sucesso a base de conhecimentos, a página base do Conhecimento abre.After QnA Maker successfully creates the knowledge base, the Knowledge base page opens. Pode editar o conteúdo da base de conhecimentos nesta página.You can edit the contents of the knowledge base on this page.

Adicione um novo conjunto de perguntas e respostasAdd a new question and answer set

  1. No portal QnA Maker, na página Editar, selecione + Adicione o par QnA da 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 marcação: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 marcação.Add the question as text and the answer formatted with markdown.

    O símbolo de *marcação, é usado para pontos de bala.The markdown symbol, *, is used for bullet points. É \n usado para uma nova linha.The \n is used for a new line.

    A página edita mostra o markdown.The Edit page shows the markdown. Quando utilizar o painel de teste mais tarde, verá a marcação corretamente exibida.When you use the Test panel later, you will see the markdown displayed properly.

Guardar e prepararSave and train

Na parte superior direita, selecione Guardar e treinar para salvar as suas edidas e treinar o Fabricante QnA .In the upper right, select Save and train to save your edits and train QnA Maker . As edições só são mantidas se tiverem sido guardadas.Edits aren't kept unless they're saved.

Testar a base de conhecimentoTest the knowledge base

  1. No portal QnA Maker, na parte superior direita, selecione Teste para testar que as alterações que fez produziram efeito.In the QnA Maker portal, in the upper right, select Test to test that the changes you made took effect.

  2. Introduza uma consulta de utilizador exemplo na caixa de texto.Enter an example user query in the textbox.

    How many Azure services are used by a knowledge base?

     Introduza uma consulta de utilizador exemplo na caixa de texto.Enter an example user query in the textbox.

  3. Selecione Inspecionar para analisar a resposta de forma mais detalhada.Select Inspect to examine the response in more detail. A janela de teste é utilizada para testar as suas alterações na base de conhecimentos antes de publicar a sua base de conhecimentos.The test window is used to test your changes to the knowledge base before publishing your knowledge base.

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

Publicar a base de dados de conhecimentoPublish the knowledge base

Ao publicar uma base de conhecimento, o conteúdo test da prod sua base de conhecimentos passa do índice para um índice na pesquisa 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 de mover o conteúdo da sua base de conhecimento

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

    O serviço Criador de FAQ é agora publicado com êxito.The QnA Maker service is now successfully published. Pode utilizar o ponto final na sua aplicação ou código de bot.You can use the endpoint in your application or bot code.

    Screenshot de publicação bem sucedida

Criar um botCreate a bot

Após a publicação, pode criar um bot a partir da 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 conhecimento para diferentes regiões ou planos de preços 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 quiser apenas um bot para a base de conhecimento, utilize todos os seus bots no link do portal Azure para ver uma lista dos 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 fazalterações na base de conhecimentos e republique, não precisa de tomar mais medidas com o bot.When you make changes to the knowledge base and republish, you don't need to take further action with the bot. Já está configurado para trabalhar com a base de conhecimento, e trabalha com todas as mudanças futuras na base de conhecimento.It's already configured to work with the knowledge base, and works with all future changes to the knowledge base. Sempre que publica uma base de conhecimento, todos os bots ligados a ela são automaticamente atualizados.Every time you publish a knowledge base, all the bots connected to it are automatically updated.

  1. No portal QnA Maker, na página Publicar, selecione Create bot.In the QnA Maker portal, on the Publish page, select Create bot. Este botão só aparece depois de publicar a base de conhecimento.This button appears only after you've published the knowledge base.

    Screenshot de criar um bot

  2. Abre-se um novo separador de navegador para o portal Azure, com a página de criação do Serviço Bot Azure.A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Configure o serviço de bots Azure.Configure the Azure bot service. O bot e o QnA Maker podem partilhar o plano de serviço de aplicações web, mas não podem partilhar a aplicação web.The bot and QnA Maker can share the web app service plan, but can't share the web app. Isto significa que o nome da aplicação para o bot deve ser diferente do nome da aplicação para o serviço QnA Maker.This means the app name for the bot must be different from the app name for the QnA Maker service.

    • O que deve fazerDo
      • Mude a pega do bot - se não for única.Change bot handle - if it is not unique.
      • Selecione linguagem SDK.Select SDK Language. Assim que o bot for criado, pode transferir o código para o 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 deve fazerDon't
      • alterar as seguintes definições no portal Azure ao criar o bot.change the following settings in the Azure portal when creating the bot. São pré-povoados para a sua base de conhecimento existente:They are pre-populated for your existing knowledge base:
        • QnA Auth KeyQnA Auth Key
        • Plano de serviço de aplicativos e localizaçãoApp service plan and location
  3. Depois de criado o bot, abra o recurso de serviço Bot.After the bot is created, open the Bot service resource.

  4. Sob gestão de Bot, selecione Teste no Chat Web.Under Bot Management, select Test in Web Chat.

  5. Ao chat prompt de Digite a sua mensagem, introduza:At the chat prompt of Type your message, enter:

    Azure services?

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

    Introduza uma consulta de utilizador no chat web de teste.

O que conseguiu?What did you accomplish?

Criou uma nova base de conhecimento, adicionou uma URL pública à base de conhecimentos, adicionou o seu próprio par QnA, treinou, testou e publicou a base 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 conhecimento, criou um bot e testou o bot.After publishing the knowledge base, you created a bot, and tested the bot.

Tudo isto foi feito em poucos minutos sem ter que escrever qualquer código ou limpar o conteúdo.This was all accomplished in a few minutes without having to write any code or clean the content.

Limpar recursosClean up resources

Se não continuar para o próximo arranque rápido, elimine os recursos-quadro da QnA Maker e bot no portal Azure.If you are not continuing to the next quickstart, delete the QnA Maker and Bot framework resources in the Azure portal.

Passos seguintesNext steps

Para obter mais informações:For more information: