Início Rápido: Implantar um aplicativo no portal do LUISQuickstart: Deploy an app in the LUIS portal

Depois que o aplicativo estiver pronto para retornar previsões de enunciado para um aplicativo cliente, como um chat bot, você precisará implantar o aplicativo no ponto de extremidade de previsão.When your LUIS app is ready to return utterance predictions to a client application (for example, a chat bot), you need to deploy the app to the prediction endpoint.

Neste início rápido, você aprenderá a implantar um aplicativo.In this quickstart, you learn to deploy an application. Crie um recurso de ponto de extremidade de previsão, atribua o recurso ao aplicativo, treine e publique o aplicativo.You create a prediction endpoint resource, assign the resource to the app, train the app, and publish the app.

Pré-requisitosPrerequisites

Criar recursos LUIS no portal do AzureCreate LUIS resources in Azure portal

  1. Use este link para começar a criar recursos LUIS no portal do Azure.Use this link to begin creating LUIS resources in the Azure portal.

  2. Insira todas as configurações necessárias:Enter all required settings:

    NomeName FinalidadePurpose
    Nome da assinaturaSubscription name a assinatura que será cobrada pelo recurso.the subscription that will be billed for the resource.
    Resource groupResource group O nome de um grupo de recursos personalizado que você escolher ou criar.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.
    NomeName Um nome personalizado que você escolhe, usado como um subdomínio personalizado para as consultas de ponto de extremidade de criação e previsão.A custom name you choose, used as your custom subdomain for your authoring and prediction endpoint queries.
    Localização de criaçãoAuthoring location A região associada ao seu modelo.The region associated with your model.
    Tipo de preço de criaçãoAuthoring pricing tier O tipo de preço determina a transação máxima por segundo e por mês.The pricing tier determines the maximum transaction per second and month.
    Localização do runtimeRuntime location A região associada ao runtime do ponto de extremidade de previsão publicado.The region associated with your published prediction endpoint runtime.
    Tipo de preço do runtimeRuntime pricing tier O tipo de preço determina a transação máxima por segundo e por mês.The pricing tier determines the maximum transaction per second and month.

    Criar o recurso de reconhecimento vocalCreate the language understanding resource

  3. Clique em Revisar + criar e aguarde até que o recurso seja criado.Click Review + create and wait for the resource to be created.

  4. Após a criação dos dois recursos, ainda no portal do Azure, selecione o novo recurso de criação e, em seguida, Inícios Rápido para obter a URL do ponto de extremidade de criação e a chave para criação de maneira programática.After both resources are created, still in the Azure portal, select the new authoring resource, then Quickstarts to get the authoring endpoint URL and key for authoring programmatically.

Dica

Para usar os recursos, no portal do LUIS, atribua os recursos.To use the resources, in the LUIS portal, assign the resources.

Atribuir a chave de recurso para o aplicativo LUIS no portal do LUISAssign the resource key to the LUIS app in the LUIS portal

Sempre que você criar um recurso de previsão de criação ou consulta para LUIS, será necessário atribuir o recurso para o aplicativo LUIS.Every time you create a new authoring or query prediction resource for LUIS, you need to assign the resource to the LUIS app. Após a atribuição, você não precisará realizar esta etapa novamente, a menos que crie um novo recurso.After it's assigned, you won't need to do this step again unless you create a new resource. Você pode criar um novo recurso para expandir as regiões do seu aplicativo ou para dar suporte a um número maior de consultas de previsão.You might create a new resource to expand the regions of your app or to support a higher number of prediction queries.

  1. Entre no portal do LUIS e escolha o aplicativo myEnglishApp na lista de aplicativos.Sign in to the LUIS portal and choose the myEnglishApp app from the apps list.

  2. Selecione Gerenciar no menu superior direito e, em seguida, selecione Recursos do Azure.Select Manage in the upper-right menu, and then select Azure Resources.

  3. Para adicionar o LUIS, selecione Adicionar recurso de previsão.To add the LUIS, select Add prediction resource.

    Para adicionar o recurso de previsão do LUIS, selecione Adicionar recurso de previsão

  4. Selecione o locatário, a assinatura e o nome do recurso.Select your tenant, subscription, and resource name. Selecione Atribuir recurso.Select Assign resource.

    Atribuir um recurso ao seu aplicativoAssign a resource to your app

  5. Conclua as mesmas etapas para adicionar a chave de criação ao seu aplicativo.Complete the same steps to add the authoring key to your app.

  6. Localize a nova linha na tabela do novo recurso de previsão e copie a URL do ponto de extremidade.Find the new row in the table for the new prediction resource and copy the endpoint URL. Ela é construída corretamente para criar uma solicitação HTTP GET para o ponto de extremidade da API do LUIS para uma previsão.It's correctly constructed to make an HTTP GET request to the LUIS API endpoint for a prediction.

Dica

Se pretender usar o aprendizado ativo para aprimorar seu aplicativo LUIS, selecione Alterar parâmetros de consulta e selecione Salvar logs.If you intend to use Active learning to improve your LUIS app, select Change query parameters and select Save logs. Essa ação altera a URL de exemplo adicionando o parâmetro querystring log=true.This action changes the example URL by adding the log=true querystring parameter. Copie e use a URL de consulta de exemplo alterada ao fazer consultas de previsão para o ponto de extremidade do runtime.Copy and use the changed example query URL when making prediction queries to the runtime endpoint.

Treinar o aplicativoTrain the app

Se você alterou o aplicativo desde que o treinou pela última vez, treine o aplicativo.If you changed the app since you trained it last, train the app.

Publicar o aplicativo no ponto de extremidade de previsãoPublish the app to the prediction endpoint

Para receber uma previsão do LUIS em um chatbot ou em outro aplicativo cliente, publique o aplicativo no ponto de extremidade de previsão.In order to receive a LUIS prediction in a chat bot or other client application, you need to publish the app to the prediction endpoint.

  1. Selecione Publicar no painel de navegação superior direito.Select Publish in the top-right navigation.

    Captura de tela da publicação do LUIS para o botão do ponto de extremidade no menu à direita superior

  2. Selecione o slot de Produção e Concluído.Select the Production slot, then select Done.

    Captura de tela da publicação do LUIS para o ponto de extremidadeScreenshot of LUIS publish to endpoint

  3. Selecione o link Acessar as URLs do ponto de extremidade na notificação para ir à página Recursos do Azure.Select the Access your endpoint URLs link in the notification to go to the Azure Resources page. As URLs do ponto de extremidade são listadas como a Consulta de Exemplo.The endpoint URLs are listed as the Example Query.

Solicitação de ponto de extremidade de previsãoPrediction endpoint request

No portal, query= no final da URL é onde o enunciado do usuário é anexado à solicitação GET.In the portal, query= at the end of the URL is where the user's utterance is appended to the GET request. Após query=, insira a mesma expressão de usuário usado no final do guia de início rápido anterior:After the query=, enter the same user utterance used at the end of the previous quickstart:

Is there a form named hrf-234098

Verifique se a cadeia de caracteres de consulta inclui os seguintes pares:Make sure the query string includes the following pairs:

  • show-all-intents=true
  • verbose=true

O navegador mostra a resposta:The browser shows the response:

{
    "query": "Is there a form named hrf-234098",
    "prediction": {
        "topIntent": "FindForm",
        "intents": {
            "FindForm": {
                "score": 0.9768753
            },
            "None": {
                "score": 0.0216071177
            }
        },
        "entities": {
            "Human Resources Form Number": [
                "hrf-234098"
            ],
            "$instance": {
                "Human Resources Form Number": [
                    {
                        "type": "Human Resources Form Number",
                        "text": "hrf-234098",
                        "startIndex": 22,
                        "length": 10,
                        "modelTypeId": 8,
                        "modelType": "Regex Entity Extractor",
                        "recognitionSources": [
                            "model"
                        ]
                    }
                ]
            }
        }
    }
}

Para ver este mesmo nível de informações no painel de teste, publique o aplicativo.To see this same level of information in the test pane, you must publish the app. Depois que o aplicativo for publicado, selecione Comparar ao publicado no painel de teste.After the app is published, select Compare with published in the test pane. Use Mostrar exibição JSON no painel de teste publicado para ver o mesmo JSON da etapa anterior.Use Show JSON view in the published test pane to see the same JSON as the previous step. Dessa forma, você poderá comparar as alterações no aplicativo atual em que está trabalhando com um aplicativo publicado no ponto de extremidade.In this way, you can compare changes to the current app you're working on with an app that is published to the endpoint.

Compare editando no momento versus a versão publicada do aplicativoCompare currently editing versus published version of app

Limpar os recursosClean up resources

Quando você concluir este guia de início rápido, selecione Meus aplicativos no menu de navegação superior.When you're done with this quickstart, select My apps from the top navigation menu. Marque a caixa de seleção do aplicativo na lista e selecione Excluir na barra de ferramentas de contexto acima da lista.Select the app's check box from the list, and then select Delete from the context toolbar above the list.

Próximas etapasNext steps