Como criar e gerir recursos LUIS

Importante

O LUIS será reformado a 1 de outubro de 2025 e a partir de 1 de abril de 2023 não poderá criar novos recursos LUIS. Recomendamos migrar as suas aplicações LUIS para a compreensão da linguagem de conversação para beneficiar do suporte contínuo do produto e das capacidades multilingues.

Use este artigo para aprender sobre os tipos de recursos Azure que você pode usar com LUIS, e como geri-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 operações de autoria
• 1.000 pedidos de previsão de previsão 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 (nível livre): 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 do Azure ou Azure CLI. Depois de criar os seus recursos, terá de os atribuir às suas apps para serem utilizadas por elas.

Portal do LUIS

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 As Minhas Aplicações 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.

   

   Ao 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 Adicionar Previsão .

   

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

   

Sem o portal LUIS

Criar recursos LUIS sem utilizar o portal LUIS

Utilize o CLI Azure para criar cada recurso individualmente.

Dica

• O recurso kind de autoria é LUIS.Authoring
• O recurso kind de previsão é LUIS

1. Inscreva-se no Azure CLI:

   az login
   

   Este comando abre um browser para que possa selecionar a conta correta e fornecer autenticação.

2. Crie um recurso de autoria LUIS, LUIS.Authoringdenominado my-luis-authoring-resource. Crie-o no grupo de recursos existente nomeado my-resource-group para a westus região.

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. Crie um recurso de ponto final de previsão LUIS, LUISdenominado my-luis-prediction-resource. Crie-o no grupo de recursos existente nomeado my-resource-group para a westus região. Se quiser uma produção mais elevada do que o nível livre proporciona, mude F0 para S0. Saiba mais sobre os níveis de preços e a produção.

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

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.

Portal do LUIS

Atribuir recursos através do portal LUIS

Atribua um recurso de autoria a todas as suas aplicações

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 do 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 da Azure:

   

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.

Sem o portal LUIS

Atribuir recurso de previsão sem utilizar o portal LUIS

Para processos automatizados como os oleodutos CI/CD, pode automatizar a atribuição de um recurso LUIS a uma aplicação LUIS com os seguintes passos:

1. Obtenha um símbolo Resource Manager Azure, que é uma cadeia alfanumérica de caracteres. Este símbolo expira, então use-o imediatamente. Também pode utilizar o seguinte comando Azure CLI.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Utilize o token para solicitar os recursos de execução do LUIS através de subscrições. Utilize a API para obter a conta LUIS Azure a que a sua conta de utilizador tem acesso.

   Esta API POST requer os seguintes valores:

   Cabeçalho	Valor
   Authorization	O valor deAuthorization.Bearer {token} O valor simbólico deve ser precedido pela palavra Bearer e por um espaço.
   Ocp-Apim-Subscription-Key	A sua chave de autoria.

   A API devolve uma série de objetos JSON que representam as suas assinaturas LUIS. Os valores devolvidos incluem o ID de subscrição, o grupo de recursos e o nome do recurso, devolvidos como AccountName. Encontre o item na matriz que é o recurso LUIS que pretende atribuir à app LUIS.

3. Atribua o token ao recurso LUIS utilizando as contas Atribuição a Azure de Atribuição a uma API de aplicação .

   Esta API POST requer os seguintes valores:

   Tipo	Definição	Valor
   Cabeçalho	Authorization	O valor deAuthorization.Bearer {token} O valor simbólico deve ser precedido pela palavra Bearer e por um espaço.
   Cabeçalho	Ocp-Apim-Subscription-Key	A sua chave de autoria.
   Cabeçalho	Content-type	application/json
   Consulta	appid	Pelo ID de aplicação do LUIS.
   Corpo		{AzureSubscriptionId: O seu ID de assinatura, ResourceGroup: Nome do Grupo de Recursos que tem o seu recurso de previsão, AccountName: Nome do seu recurso de previsão}

   Quando esta API tiver sucesso, regressa 201 - created status.

Unassigna um recurso

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

Portal do LUIS

Recursos de unassign usando portal LUIS

1. Inscreva-se no portal LUIS e, em seguida, selecione uma aplicação da lista de aplicações My .
2. Vá para gerir> recursosAzure.
3. Selecione o botão de recurso Unassign para o recurso.

Sem o portal LUIS

Recurso de previsão de adignação sem usar o portal LUIS

1. Obtenha um símbolo Resource Manager Azure, que é uma cadeia alfanumérica de caracteres. Este símbolo expira, então use-o imediatamente. Também pode utilizar o seguinte comando Azure CLI.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Utilize o token para solicitar os recursos de execução do LUIS através de subscrições. Utilize a conta Get LUIS Azure API, à qual a sua conta de utilizador tem acesso.

   Esta API POST requer os seguintes valores:

   Cabeçalho	Valor
   Authorization	O valor deAuthorization.Bearer {token} O valor simbólico deve ser precedido pela palavra Bearer e por um espaço.
   Ocp-Apim-Subscription-Key	A sua chave de autoria.

   A API devolve uma série de objetos JSON que representam as suas assinaturas LUIS. Os valores devolvidos incluem o ID de subscrição, o grupo de recursos e o nome do recurso, devolvidos como AccountName. Encontre o item na matriz que é o recurso LUIS que pretende atribuir à app LUIS.

3. Atribua o token ao recurso LUIS utilizando a conta Desatribuição de Azure a partir de uma aplicação API.

   Esta API DELETE requer os seguintes valores:

   Tipo	Definição	Valor
   Cabeçalho	Authorization	O valor deAuthorization.Bearer {token} O valor simbólico deve ser precedido pela palavra Bearer e por um espaço.
   Cabeçalho	Ocp-Apim-Subscription-Key	A sua chave de autoria.
   Cabeçalho	Content-type	application/json
   Consulta	appid	Pelo ID de aplicação do LUIS.
   Corpo		{AzureSubscriptionId: O seu ID de assinatura, ResourceGroup: Nome do Grupo de Recursos que tem o seu recurso de previsão, AccountName: Nome do seu recurso de previsão}

   Quando esta API tiver sucesso, regressa 200 - OK status.

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.

Consulte os limites de recursos para obter mais informações.

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 do Azure, vá a todos os recursos e selecione o seu recurso

   

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 do Azure. A página 'Visão Geral ' mostra um resumo, incluindo chamadas e erros recentes. Se fizer um pedido de ponto final LUIS, deixe até cinco minutos para que a alteração apareça.

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.

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

   

3. Clique na condição de Adicionar

   

4. Selecione Total chamadas

   

5. Desloque-se até à secção lógica de alerta e desloque os atributos como deseja e clique em Fazer

   

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.

   

Redefinir uma chave de autoria

Para aplicações de recursos de autoria migradas: Se a sua chave de autoria estiver comprometida, reinicie a chave na portal do Azure, na página Keys 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 você autorize as suas aplicações através das APIs de autoria, você precisa alterar o valor da Ocp-Apim-Subscription-Key nova chave.

Regenerar uma chave azul

Pode regenerar uma chave Azure a partir da página Keys na portal do 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 do Azure ou Azure CLI:

• Mover uma app entre recursos de autoria LUIS
• Mover um recurso para um novo grupo de recursos ou subscrição
• Mover um recurso dentro da mesma subscrição ou através de subscrições

Passos seguintes

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