Tutorial: Criar um Bot do QnA com o Serviço de Bot do Azure v4Tutorial: Create a QnA Bot with Azure Bot Service v4

Crie um chatbot do QnA a partir da página Publicar para uma base de conhecimento existente.Create a QnA chat bot from the Publish page for an existing knowledge base. Este bot usa o Bot Framework SDK v4.This bot uses the Bot Framework SDK v4. Não é preciso escrever qualquer código para construir o bot, todo o código é fornecido para você.You do not need to write any code to build the bot, all the code is provided for you.

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

  • Criar um Serviço de Bot do Azure a partir de uma base de conhecimento existenteCreate an Azure Bot Service from an existing knowledge base
  • Conversar com o bot para verificar se o código está funcionandoChat with the bot to verify the code is working

Pré-requisitosPrerequisites

Você precisa ter uma base de dados de conhecimento publicada para este tutorial.You need to have a published knowledge base for this tutorial. Se você não tiver uma, siga as etapas no tutorial Criar e responder a partir de KB para criar uma base de conhecimento do QnA Maker com perguntas e respostas.If you do not have one, follow the steps in Create and answer from KB tutorial to create a QnA Maker knowledge base with questions and answers.

Criar um bot de QnACreate a QnA Bot

Crie um bot como um aplicativo cliente para a base de conhecimento.Create a bot as a client application for the knowledge base.

  1. No portal do QnA Maker, vá para a página Publicar e publique sua base de dados de conhecimento.In the QnA Maker portal, go to the Publish page, and publish your knowledge base. Selecione Criar Bot.Select Create Bot.

    No portal do QnA Maker, vá para a página Publicar e publique sua base de dados de conhecimento.

    O portal do Azure é aberto com a configuração de criação do bot.The Azure portal opens with the bot creation configuration.

  2. Insira as configurações para criar o bot:Enter the settings to create the bot:

    ConfiguraçãoSetting ValorValue FinalidadePurpose
    Nome do botBot name my-tutorial-kb-bot Esse é o nome do recurso do Azure para o bot.This is the Azure resource name for the bot.
    SubscriptionSubscription Confira a finalidade.See purpose. Selecione a mesma assinatura que você usou para criar os recursos do QnA Maker.Select the same subscription as you used to create the QnA Maker resources.
    Resource groupResource group my-tutorial-rg O grupo de recursos usado para todos os recursos do Azure relacionados ao bot.The resource group used for all the bot-related Azure resources.
    LocationLocation west us O local do recurso do Azure do bot.The bot's Azure resource location.
    Tipo de preçoPricing tier F0 A camada de serviço gratuita para o serviço de bot do Azure.The free tier for the Azure bot service.
    Nome do aplicativoApp name my-tutorial-kb-bot-app Este é um aplicativo da Web para oferecer suporte apenas ao seu bot.This is a web app to support your bot only. Não deve ser o mesmo nome do aplicativo que o seu serviço do QnA Maker já está usando.This should not be the same app name as your QnA Maker service is already using. Não há suporte para o compartilhamento do aplicativo da Web do QnA Maker com qualquer outro recurso.Sharing QnA Maker's web app with any other resource is not supported.
    Linguagem do SDKSDK Language C#C# Esta é a linguagem de programação subjacente usada pelo bot framework SDK.This is the underlying programming language used by the bot framework SDK. Suas opções são C# ou Node. js.Your choices are C# or Node.js.
    Chave de autenticação do QnAQnA Auth Key Não alterarDo not change Esse valor é preenchido para você.This value is filled in for you.
    Local/plano de serviço de aplicativoApp service plan/Location Não alterarDo not change Para este tutorial, a localização não é importante.For this tutorial, the location is not important.
    Armazenamento do AzureAzure Storage Não alterarDo not change Os dados de conversa são armazenados nas tabelas do Armazenamento do Azure.Conversation data is stored in Azure Storage tables.
    Application InsightsApplication Insights Não alterarDo not change O registro em log é enviado para o Application Insights.Logging is sent to Application Insights.
    ID do Aplicativo da MicrosoftMicrosoft App ID Não alterarDo not change O usuário e a senha do Active Directory são obrigatórios.Active directory user and password is required.

    Crie o bot de base de conhecimento com essas configurações.

    Aguarde alguns minutos até que a notificação do processo de criação do bot relate sucesso.Wait a couple of minutes until the bot creation process notification reports success.

Conversar com o botChat with the Bot

  1. No portal do Azure, abra o novo recurso de bot a partir da notificação.In the Azure portal, open the new bot resource from the notification.

    No portal do Azure, abra o novo recurso de bot a partir da notificação.

  2. Em Gerenciamento de bot, selecione Testar no Webchat e digite: How large can my KB be?.From Bot management, select Test in Web Chat and enter: How large can my KB be?. O bot responderá com:The bot will respond with:

    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.

    testar o novo bot de base de conhecimento.

    Para saber mais sobre os bots do Azure, confira Usar o QnA Maker para responder perguntasFor more information about Azure Bots, see Use QnA Maker to answer questions

Limpar recursosClean up resources

Quando você terminar com o bot deste tutorial, remova-o no portal do Azure.When you are done with this tutorial's bot, remove the bot in the Azure portal.

Se você criou um novo grupo de recursos para os recursos do bot, exclua o grupo de recursos.If you created a new resource group for the bot's resources, delete the resource group.

Se você não criou um novo grupo de recursos, precisará encontrar os recursos associados ao bot.If you didn't create a new resource group, you need to find the resources associated with the bot. A maneira mais fácil é pesquisar pelo nome do bot e do aplicativo do bot.The easiest way is to search by the name of the bot and bot app. Os recursos de bot incluem:The bot resources include:

  • O plano do Serviço de AplicativoThe App Service plan
  • O serviço SearchThe Search service
  • O serviços CognitivosThe Cognitive service
  • O serviço de AplicativoThe App service
  • Opcionalmente, também pode incluir o serviço application insights e o armazenamento para os dados do application insightsOptionally, it may also include the application insights service and storage for the application insights data

Mais informações sobre botsMore information about bots

Para obter mais informações sobre como usar esse serviço com bots, comece com os seguintes recursos:For more information about using this service with bots, begin with the following resources:

RecursoResource FinalidadePurpose
Serviço de Bot do AzureAzure Bot service O Serviço de Bot do Azure fornece um serviço Web hospedado na nuvem completo com um ponto de extremidade de bot.The Azure Bot service provides a complete cloud-hosted web service with a bot endpoint. Os serviços usam o Bot Framework, que está disponível em vários idiomas.The services uses Bot framework, which is available in several languages.
Bot FrameworkBot Framework O Microsoft Bot Framework é uma plataforma abrangente para a criação de experiências de conversação por inteligência artificial de nível empresarial.The Microsoft Bot Framework is a comprehensive platform for building enterprise-grade conversational AI experiences.
Emulador do bot FrameworkBot Framework Emulator O Bot Framework Emulator é um aplicativo de área de trabalho multiplataforma que permite aos desenvolvedores testar e depurar bots criados usando o SDK do Bot Framework.The Bot Framework Emulator is a cross-platform desktop application that allows bot developers to test and debug bots built using the Bot Framework SDK. Você pode usar o Bot Framework Emulator para testar bots em execução localmente no computador ou para se conectar a bots em execução remotamente.You can use the Bot Framework Emulator to test bots running locally on your machine or to connect to bots running remotely.
Ferramentas de botBot tools As ferramentas do Bot Framework são uma coleção de ferramentas de linha de comando multiplataforma, projetadas para cobrir o fluxo de trabalho de desenvolvimento de bot de ponta a ponta.The Bot Framework tools are a collection of cross-platform command line tools designed to cover end-to-end bot development workflow.
Exemplos do construtor de botBot builder samples Os exemplos de bots completos são projetados para ilustrar os cenários que você precisará implementar para criar ótimos bots.Full-developed bot samples are designed to illustrate scenarios you'll need to implement to build great bots.

Próximas etapasNext steps

Consulte tambémSee also