Como criar e gerir recursos LUIS

Use este artigo para aprender sobre os tipos de recursos Azure que você pode usar com LUIS, e como gerá-los.

Recurso de autoria

Um recurso de autoria permite-lhe criar, gerir, treinar, testar e publicar as suas aplicações. Um nível de preços está disponível para o recurso de autoria LUIS - o nível gratuito (F0), que lhe dá:

  • 1 milhão de transações de autoria
  • 1.000 pedidos de previsão de teste por mês.

Pode utilizar as APIs programáticas luis de pré-visualização v3.0 para gerir recursos de autoria.

Recurso de previsão

Um recurso de previsão permite-lhe consultar o seu ponto final de previsão para além dos 1.000 pedidos fornecidos pelo recurso de autoria. Estão disponíveis dois níveis de preços para o recurso de previsão:

  • O recurso de previsão gratuito (F0), que lhe dá 10.000 pedidos mensais de previsão.
  • Recurso de previsão padrão (S0), que é o nível pago.

Pode utilizar a API de ponto final de pré-visualização V3.0 para gerir os recursos de previsão.

Nota

  • Também pode usar um recurso multi-serviço para obter um único ponto final que pode usar para vários Serviços Cognitivos.
  • A LUIS fornece dois tipos de recursos F0 (free tier): um para a autoria de transações e outro para transações de previsão. Se estiver a ficar sem quota gratuita para transações de previsão, certifique-se de que está a usar o recurso de previsão F0, que lhe dá 10.000 transações gratuitas mensais, e não o recurso de autoria, o que lhe dá 1.000 transações de previsão mensais.
  • Você deve autor de aplicativos LUIS nas regiões onde você quer publicar e consultar.

Criar recursos LUIS

Para criar recursos LUIS, pode utilizar o portal LUIS, portal Azure,ou Azure CLI. Depois de criar os seus recursos, terá de os atribuir às suas apps para serem utilizadas por elas.

Criar um recurso de autoria LUIS utilizando o portal LUIS

  1. Inscreva-se no portal LUIS,selecione o seu país/região e concorde com os termos de utilização. Se vir a secção My Apps no portal, já existe um recurso LUIS e pode saltar o passo seguinte.

  2. Na janela de autoria Escolha uma janela de autoria que apareça, encontre a sua assinatura Azure e recurso de autoria LUIS. Se não tiver um recurso, pode criar um novo.

    Escolha um tipo de recurso de autoria de compreensão linguística.

    Quando criar um novo recurso de autoria, forneça as seguintes informações:

    • Nome do inquilino: o inquilino a que a sua assinatura Azure está associada.
    • Nome de subscrição Azure: a subscrição que será faturada para o recurso.
    • Nome do grupo de recursos Azure: um nome de grupo de recursos personalizado que escolher ou criar. Os grupos de recursos permitem-lhe agrupar recursos Azure para acesso e gestão.
    • Nome do recurso Azure: um nome personalizado que você escolhe, usado como parte do URL para as suas consultas de autoria e previsão de ponto final.
    • Nível de preços: o nível de preços determina a transação máxima por segundo e mês.

Criar um recurso de previsão LUIS utilizando o portal LUIS

  1. Vá ao separador Gerir na sua aplicação.

  2. Na navegação à esquerda, selecione Recursos Azure.

  3. clique no botão de recurso De previsão de previsão.

    Adicionar recurso de previsão do portal

    Se já tem um recurso de previsão, adicione-o. Caso contrário, selecione Criar um novo recurso de previsão.

    Adicionar recurso de previsão do portal-2

Atribuir recursos LUIS

Criar um recurso não significa necessariamente que seja usado, é necessário atribuí-lo às suas apps. Pode atribuir um recurso de autoria para uma única aplicação ou para todas as aplicações no LUIS.

Atribuir recursos através do portal LUIS

Atribua um recurso de autoria a todas as suas apps

O procedimento a seguir atribui o recurso de autoria a todas as aplicações.

  1. Inscreva-se no portal LUIS.
  2. No canto superior direito, selecione a sua conta de utilizador e, em seguida, selecione Definições.
  3. Na página Definições utilizador, selecione Adicionar o recurso de autoria e, em seguida, selecione um recurso de autoria existente. Selecione Guardar.

Atribuir um recurso a uma aplicação específica

O procedimento a seguir atribui um recurso a uma aplicação específica.

  1. Inscreva-se no portal LUIS. Selecione uma aplicação da lista de aplicações My.

  2. Ir para gerir > recursos Azure:

    Escolha um tipo de recurso de previsão de compreensão linguística.

  3. No separador de recursos de previsão ou de autoria, selecione o recurso de previsão Adicionar ou Adicione o botão de recurso de autoria.

  4. Utilize os campos no formulário para encontrar o recurso correto e, em seguida, selecione Guardar.

Não assinar um recurso

Quando se não dá a assinatura de um recurso, não é apagado do Azure. Só está desvinculado do LUIS.

Recursos de unassign usando portal LUIS

  1. Inscreva-se no portal LUISe, em seguida, selecione uma aplicação da lista de aplicações My.
  2. Ir para gerir recursos > Azure.
  3. Selecione o botão de recurso Unassign para o recurso.

Propriedade de recursos

Um recurso Azure, como um recurso LUIS, é propriedade da subscrição que contém o recurso.

Para alterar a propriedade de um recurso, pode tomar uma destas ações:

  • Transfira a propriedade da sua subscrição.
  • Exporte a app LUIS como um ficheiro e, em seguida, importe a app numa subscrição diferente. A exportação está disponível na página my apps no portal LUIS.

Limites de recursos

Autoria de limites-chave de criação

Pode criar até 10 chaves de autoria por região, por subscrição. As regiões editoriais são diferentes das regiões de autoria. Certifique-se de criar uma aplicação na região de autoria que corresponda à região editorial onde pretende que a sua aplicação de cliente seja localizada. Para obter informações sobre como as regiões de autoria mapeiam para as regiões editoriais, consulte as regiões de Autoria e publicação.

Para obter mais informações sobre os limites-chave, consulte os limites-chave.

Erros para os limites de utilização chave

Os limites de utilização baseiam-se no nível de preços.

Se exceder a quota de transações por segundo (TPS), receberá um erro 429 de HTTP. Se exceder a sua quota de transação por mês (TPM), recebe um erro HTTP 403.

Alterar o nível de preços

  1. No portal Azure, Vá a Todos os recursos e selecione o seu recurso

    Screenshot que mostra uma assinatura LUIS no portal Azure.

  2. A partir do menu do lado esquerdo, selecione o nível de preços para ver os níveis de preços disponíveis

  3. Selecione o nível de preços que deseja e clique em Selecionar para guardar o seu alterar. Quando a alteração de preços estiver concluída, aparecerá uma notificação no canto superior direito com a atualização do nível de preços.

Ver métricas de recursos Azure

Ver um resumo da utilização do recurso Azure

Pode ver informações de utilização do LUIS no portal Azure. A página 'Visão Geral' mostra um resumo, incluindo chamadas e erros recentes. Se fizer um pedido de ponto final LUIS, permita até cinco minutos para que a alteração apareça.

Screenshot que mostra a página geral.

Personalizar gráficos de utilização de recursos Azure

A página Métricas fornece uma visão mais detalhada dos dados. Pode configurar os seus gráficos de métricas para um período de tempo e métrica específicos.

Screenshot que mostra a página de métricas.

Alerta de limiar total de transações

Se quiser saber quando atingir um determinado limiar de transação, por exemplo 10.000 transações, pode criar um alerta:

  1. A partir do menu do lado esquerdo selecione Alertas

  2. A partir do menu superior selecione Nova regra de alerta

    Screenshot que mostra a página de regras de alerta.

  3. Clique na condição de adicionar

    Screenshot que mostra a página de condição de adicionar para regras de alerta.

  4. Selecione Total chamadas

    Screenshot que mostra a página total de chamadas para alertas.

  5. Percorra para baixo para a secção lógica de alerta e desloque os atributos como deseja e clique em Fazer

    Screenshot que mostra a página lógica de alerta.

  6. Para enviar notificações ou invocar ações quando a regra de alerta desencadear, vá à secção Ações e adicione o seu grupo de ação.

    Screenshot que mostra a página de ações para alertas.

Redefinir uma chave de autoria

Para aplicações de recursos de autoria migradas: Se a sua chave de autoria estiver comprometida, reinicie a chave no portal Azure, na página Chaves para o recurso de autoria.

Para aplicações que não tenham sido migradas: A chave é reposta em todas as suas aplicações no portal LUIS. Se autorize as suas aplicações através das APIs de autoria, tem de alterar o valor da Ocp-Apim-Subscription-Key nova chave.

Regenerar uma chave azul

Pode regenerar uma chave Azure a partir da página Chaves no portal Azure.

Propriedade, acesso e segurança de aplicativos

Uma aplicação é definida pelos seus recursos Azure, que são determinados pela subscrição do proprietário.

Pode mover a sua aplicação LUIS. Utilize os seguintes recursos para o ajudar a fazê-lo utilizando o portal Azure ou O Azure CLI:

Passos seguintes

  • Aprenda a usar versões para controlar o ciclo de vida da sua aplicação.