Início Rápido: Criar um aplicativo no portal do LUISQuickstart: Create a new app in the LUIS portal

Neste início rápido, você criará um aplicativo no portal do LUIS.In this quickstart, you build a new app in the LUIS portal. Primeiro, crie as partes básicas de um aplicativo, intenções e entidades.First, create the basic parts of an app, intents, and entities. Em seguida, teste o aplicativo fornecendo um enunciado de usuário de exemplo no painel de teste interativo para obter a intenção prevista.Then test the app by providing a sample user utterance in the interactive test panel to get the predicted intent.

Entrar no portal do LUISSign in to LUIS portal

Um novo usuário do LUIS precisa seguir este procedimento:A new user to LUIS needs to follow this procedure:

  1. Entrar no portal do LUIS, selecionar seu país/região e concordar com os termos de uso.Sign in to LUIS portal, select your country/region and agree to the terms of use. Caso, em vez disso, você consulte Meus aplicativos, um recurso do LUIS já existirá e você deverá avançar e criar um aplicativo.If you see My Apps instead, a LUIS resource already exists and you should skip ahead to create an app. Para regiões com suporte, visite regiões de criação e de publicação e as chaves associadas.For supported regions, visit authoring and publishing regions and the associated keys.

  2. Selecionar Criar recurso do Azure e, em seguida, selecionar Criar um recurso de criação para o qual migrar seus aplicativos.Select Create Azure resource then select Create an authoring resource to migrate your apps to.

    Escolher um tipo de recurso de criação de Reconhecimento Vocal

  3. Preencher os detalhes do recurso.Fill in the details for the resource.

    Criar recurso de criação

    Ao criar um novo recurso de criação, forneça as seguintes informações:When creating a new authoring resource, provide the following information:

    • Nome do recurso – um nome personalizado que você escolher, usado como parte da URL para as consultas de ponto de extremidade de criação e previsão.Resource name - a custom name you choose, used as part of the URL for your authoring and prediction endpoint queries.
    • Locatário – o locatário ao qual sua assinatura do Azure está associada.Tenant - the tenant your Azure subscription is associated with.
    • Nome da assinatura – a assinatura que será cobrada pelo recurso.Subscription name - the subscription that will be billed for the resource.
    • Grupo de recursos – o nome de um grupo de recursos personalizado que você escolher ou criar.Resource group - a custom resource group name you choose or create. Os grupos de recursos permitem agrupar os recursos do Azure para acesso e gerenciamento.Resource groups allow you to group Azure resources for access and management.
    • Local – a escolha de local é baseada na seleção do grupo de recursos.Location - the location choice is based on the resource group selection.
    • Tipo de preço – o tipo de preço determina a transação máxima por segundo e mês.Pricing tier - the pricing tier determines the maximum transaction per second and month.
  4. Um resumo do recurso a ser criado é exibido.A summary of the resource to be created is displayed. Selecione Avançar.Select Next.

    Criar recurso de criação

  5. Confirme selecionando Continuar.Confirm by selecting Continue.

    Criar recurso de criação

Criar um aplicativoCreate an app

  1. Selecione + Novo aplicativo para conversa na barra de ferramentas de contexto, em seguida, selecione + Novo aplicativo para conversa novamente.Select + New app for conversation from the context toolbar, then select + New app for conversation again.

    Captura de tela da criação de novo aplicativo no portal do LUISScreenshot of creating new app in LUIS portal

  2. Na janela pop-up, configure o aplicativo com as configurações a seguir e, em seguida, selecione Concluído.In the pop-up window, configure the app with the following settings and then select Done.

    Nome da configuraçãoSetting name ValorValue FinalidadePurpose
    NomeName myEnglishApp Nome exclusivo de aplicativo LUISUnique LUIS app name
    obrigatóriorequired
    CulturaCulture InglêsEnglish Linguagem de enunciados de usuários, pt-brLanguage of utterances from users, en-us
    obrigatóriorequired
    Descrição (opcional)Description (Optional) App made with LUIS Portal Descrição do aplicativoDescription of app
    opcionaloptional
    Recurso de previsão (opcional)Prediction resource (Optional) - Não selecione.Do not select. O LUIS fornece uma chave de início para ser usada gratuitamente com a finalidade de criação e 1.000 solicitações de ponto de extremidade de previsão.LUIS gives you a Starter key to use for free for authoring and 1,000 prediction endpoint requests.

    Captura de tela da inserção de novas configurações do aplicativo

Criar intençõesCreate intents

Depois de criar o aplicativo LUIS, você precisará criar intenções.After the LUIS app is created, you need to create intents. As intenções são uma forma de classificar o texto dos usuários.Intents are a way to classify text from users. Por exemplo, um aplicativo de recursos humanos pode ter duas funções.For example, a human resources app might have two functions. Ajudar as pessoas a:To help people:

  1. Encontrar um emprego e se candidatar a eleFind and apply for jobs
  2. Encontrar formulários para se candidatar a um empregoFind forms to apply for jobs

As duas diferentes intenções do aplicativo se alinham com as seguintes intenções:The app's two different intentions align to the following intents:

IntencionalIntent Exemplo de texto do usuárioExample text from user
conhecido como um enunciadoknown as an utterance
ApplyForJobApplyForJob I want to apply for the new software engineering position in Cairo.
FindFormFindForm Where is the job transfer form hrf-123456?

Para criar intenções, conclua as seguintes etapas:To create intents, complete the following steps:

  1. Depois que o aplicativo é criado, você está na página Intenções da seção Build.After the app is created, you are on the Intents page of the Build section. Selecione Criar.Select Create.

    Captura de tela da seleção “Criar” para criar nova intençãoScreenshot of selecting 'Create' to create new intent

  2. Insira o nome da intenção, FindForm, e, em seguida, selecione Concluído.Enter the intent name, FindForm, and then select Done.

Adicionar uma expressão de exemploAdd an example utterance

Você adicionará enunciados de exemplo depois de criar intenções.You add example utterances after you create intents. Enunciados de exemplo são um texto que um usuário insere em um chatbot ou em outro aplicativo cliente.Example utterances are text that a user enters in a chat bot or other client application. Eles mapeiam a intenção de texto do usuário para uma intenção do LUIS.They map the intention of the user's text to a LUIS intent.

Para a intenção FindForm deste aplicativo de exemplo, os enunciados de exemplo incluirão o número de formulário.For this example application's FindForm intent, example utterances will include the form number. O aplicativo cliente precisa do número de formulário para atender à solicitação do usuário, portanto, é importante incluí-lo no enunciado.The client application needs the form number to fulfill the user's request, so it's important to include it in the utterance.

Captura de tela da inserção dos enunciados de exemplo para a intenção FindFormScreenshot of entering example utterances for the FindForm intent

Adicione os 15 enunciados de exemplo a seguir à intenção FindForm.Add the following 15 example utterances to the FindForm intent.

# Exemplo de enunciadosExample utterances
11 Looking for hrf-123456
22 Where is the human resources form hrf-234591?
33 hrf-345623, where is it
44 Is it possible to send me hrf-345794
55 Do I need hrf-234695 to apply for an internal job?
66 Does my manager need to know I'm applying for a job with hrf-234091
77 Where do I send hrf-234918? Do I get an email response it was received?
88 hrf-234555
99 When was hrf-234987 updated?
1010 Do I use form hrf-876345 to apply for engineering positions
1111 Was a new version of hrf-765234 submitted for my open req?
1212 Do I use hrf-234234 for international jobs?
1313 hrf-234598 spelling mistake
1414 will hrf-234567 be edited for new requirements
1515 hrf-123456, hrf-123123, hrf-234567

Por design, esses enunciados de exemplo variam das seguintes maneiras:By design, these example utterances vary in the following ways:

  • tamanho do enunciadoutterance length
  • pontuaçãopunctuation
  • escolha de palavrasword choice
  • tempos verbais (é, foi, será)verb tense (is, was, will be)
  • ordem das palavrasword order

Criar uma entidade de expressão regularCreate a regular expression entity

Para retornar o número do formulário na resposta de previsão durante a execução, o número precisa ser extraído como uma entidade.To return the form number in the runtime prediction response, the form number must be extracted as an entity. Como o texto do número do formulário é altamente estruturado, você pode usar uma entidade de expressão regular.Because the form number text is highly structured, you can use a regular expression entity. Crie a entidade de expressão regular com as seguintes etapas:Create the regular expression entity with the following steps:

  1. Selecione Entidades no menu à esquerda.Select Entities from the menu on the left.

  2. Selecione Criar na página Entidades.Select Create on the Entities page.

  3. Insira o nome FormNumber e selecione o tipo de entidade Regex.Enter the name FormNumber, select the Regex entity type.

  4. Insira a expressão regular hrf-[0-9]{6} no campo Regex.Enter the regular expression, hrf-[0-9]{6} in the Regex field. Essa entrada corresponde aos caracteres literais, hrf-, e permite exatamente seis dígitos; depois selecione Criar.This entry matches the literal characters, hrf-, and allows for exactly six digits, then select Create.

    Captura de tela da criação da entidade de expressão regularScreenshot of creating regular expression entity

    Essa entidade extrai qualquer texto que corresponda à expressão regular em qualquer uma das intenções.This entity extracts any text that matches the regular expression in any of the intents.

Adicionar enunciados de exemplo à intenção NoneAdd example utterances to the None intent

A intenção Nenhum é a intenção de fallback e não deve ser deixada vazia.The None intent is the fallback intent and shouldn't be left empty. Essa intenção deve conter um enunciado para cada dez enunciados de exemplo que você adicionou para as outras intenções do aplicativo.This intent should contain one utterance for every 10 example utterances that you've added for the other intents of the app.

Os exemplos de enunciado da intenção Nenhum devem ficar fora do seu domínio do aplicativo cliente.The None intent's example utterances should be outside of your client application domain.

  1. Selecione Intenções no menu à esquerda e, em seguida, selecione Nenhum na lista de intenções.Select Intents from the left menu, and then select None from the intents list.

  2. Adicione os quinze exemplos de enunciado a seguir à intenção:Add the following example utterances to the intent:

    Exemplos de enunciado da intenção NenhumNone intent example utterances
    Barking dogs are annoying
    Penguins in the ocean

    Para este aplicativo, esses exemplos de enunciado estão fora do domínio.For this app, these example utterances are outside the domain. Se o domínio incluir animais, ou o oceano, você deverá usar enunciados de exemplo diferentes para a intenção Nenhum.If your domain includes animals, or the ocean, then you should use different example utterances for the None intent.

Treinar o aplicativoTrain the app

  1. No lado superior direito do site do LUIS, selecione o botão Treinar.In the top-right side of the LUIS website, select the Train button.

    Botão Treinar

  2. O treinamento será concluído quando o indicador de status no botão Treinar estiver verde.Training is complete when status indicator on the Train button is green.

Examinar a entidade de expressão regular nos exemplos de enunciadoLook at the regular expression entity in the example utterances

  1. Verifique se a entidade é encontrada na intenção FindForm selecionando Intenções no menu à esquerda.Verify the entity is found in the FindForm intent by selecting Intents from the left menu. Em seguida, selecione a intenção FindForm.Then select FindForm intent.

    A entidade é marcada onde ela aparece nos exemplos de enunciado.The entity is marked where it appears in the example utterances.

    Captura de tela de todos os enunciados de exemplo marcados com entidadesScreenshot of all example utterances marked with entities

Testar seu novo aplicativo com o painel de teste interativoTest your new app with the interactive test pane

Use o painel Teste interativo no portal do LUIS para validar se a entidade é extraída de novos enunciados que o aplicativo ainda não viu.Use the interactive Test pane in the LUIS portal to validate that the entity is extracted from new utterances the app hasn't seen yet.

  1. Selecione Testar no menu superior direito.Select Test from the upper-right menu.

  2. Adicione um novo enunciado e, em seguida, pressione Enter:Add a new utterance and then press Enter:

    Is there a form named hrf-234098

    Selecione Inspecionar para ver as previsões de entidade.Select Inspect to see entity predictions.

    Captura de tela do teste do novo enunciado no painel de testeScreenshot of testing new utterance in test pane

    A primeira intenção prevista é corretamente FindForm, com uma confiança acima de 90% (0,977).The top predicted intent is correctly FindForm with over 90% confidence (0.977). A entidade FormNumber é extraída com um valor hrf-234098.The FormNumber entity is extracted with a value of hrf-234098.

Limpar os recursosClean up resources

Quando você concluir este início rápido e não estiver passando para o próximo, selecione Meus aplicativos no menu de navegação superior.When you're done with this quickstart and aren't moving on to the next quickstart, select My apps from the top navigation menu. Em seguida, marque a caixa de seleção à esquerda do aplicativo na lista e selecione Excluir na barra de ferramentas de contexto acima da lista.Then select the app's left check box from the list and select Delete from the context toolbar above the list.

Próximas etapasNext steps