Como criar e gerir recursos LUIS

Importante

O LUIS será aposentado em 1º de outubro de 2025 e a partir de 1º de abril de 2023 você não poderá criar novos recursos do LUIS. Recomendamos migrar seus aplicativos LUIS para o entendimento de linguagem conversacional para se beneficiar do suporte contínuo ao produto e dos recursos multilíngues.

Use este artigo para saber mais sobre os tipos de recursos do Azure que você pode usar com o LUIS e como gerenciá-los.

Recurso de criação

Um recurso de criação permite criar, gerenciar, treinar, testar e publicar seus aplicativos. Um nível de preço está disponível para o recurso de criação LUIS - o nível gratuito (F0), que lhe dá:

• 1 milhão de transações de criação
• 1.000 solicitações de endpoint de previsão de teste por mês.

Você pode usar as APIs programáticas LUIS v3.0-preview para gerenciar recursos de criação.

Recurso de predição

Um recurso de previsão permite consultar seu ponto de extremidade de previsão além das 1.000 solicitações fornecidas pelo recurso de criação. Dois níveis de preços estão disponíveis para o recurso de previsão:

• O recurso de previsão gratuito (F0), que oferece 10.000 solicitações de ponto de extremidade de previsão mensalmente.
• Recurso de previsão padrão (S0), que é a camada paga.

Você pode usar a v3.0-preview LUIS Endpoint API para gerenciar recursos de previsão.

Nota

• Você também pode usar um recurso multisserviço para obter um único ponto de extremidade que você pode usar para vários serviços de IA do Azure.
• O LUIS fornece dois tipos de recursos F0 (camada livre): um para criar transações e outro para transações de previsão. Se você estiver ficando sem cota gratuita para transações de previsão, certifique-se de estar usando o recurso de previsão F0, que oferece 10.000 transações gratuitas mensais, e não o recurso de criação, que oferece 1.000 transações de previsão mensalmente.
• Você deve criar aplicativos LUIS nas regiões onde deseja publicar e consultar.

Criar recursos LUIS

Para criar recursos LUIS, você pode usar o portal LUIS, o portal do Azure ou a CLI do Azure. Depois de criar seus recursos, você precisará atribuí-los aos seus aplicativos para serem usados por eles.

Portal LUIS

Criar um recurso de criação LUIS usando o portal LUIS

1. Inicie sessão 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 ignorar o passo seguinte.

2. Na janela Escolha uma criação que aparece, localize sua assinatura do Azure e o recurso de criação LUIS. Se não tiver um recurso, pode criar um novo.

   

   Ao criar um novo recurso de criação, forneça as seguintes informações:

   • Nome do locatário: o locatário ao qual sua assinatura do Azure está associada.
   • Nome da assinatura do Azure: a assinatura que será cobrada pelo recurso.
   • Nome do grupo de recursos do Azure: um nome de grupo de recursos personalizado que você escolhe ou cria. Os grupos de recursos permitem agrupar recursos do Azure para acesso e gerenciamento.
   • Nome do recurso do Azure: um nome personalizado que você escolhe, usado como parte da URL para suas consultas de ponto de extremidade de criação e previsão.
   • Nível de preço: o nível de preço determina a transação máxima por segundo e mês.

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

1. Vá para a guia Gerenciar em seu aplicativo.

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

3. selecione o botão Adicionar recurso de previsão .

   

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

   

Sem portal LUIS

Crie recursos LUIS sem utilizar o portal LUIS

Use a CLI do Azure para criar cada recurso individualmente.

Gorjeta

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

1. Entre na CLI do Azure:

   az login
   

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

2. Crie um recurso de criação LUIS do tipo LUIS.Authoring, chamado 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 de extremidade de previsão LUIS do tipo LUIS, chamado my-luis-prediction-resource. Crie-o no grupo de recursos existente nomeado my-resource-group para a westus região. Se você quiser uma taxa de transferência maior do que a camada gratuita oferece, mude F0 para S0. Saiba mais sobre níveis de preços e taxa de transferência.

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

Atribuir recursos do LUIS

Criar um recurso não significa necessariamente que ele é colocado em uso, você precisa atribuí-lo aos seus aplicativos. Você pode atribuir um recurso de criação para um único aplicativo ou para todos os aplicativos no LUIS.

Portal LUIS

Atribuir recursos usando o portal LUIS

Atribuir um recurso de criação a todos os seus aplicativos

O procedimento a seguir atribui o recurso de criação a todos os aplicativos.

1. Inicie sessão no portal LUIS.
2. No canto superior direito, selecione a sua conta de utilizador e, em seguida, selecione Definições.
3. Na página Configurações do Usuário, selecione Adicionar recurso de criação e selecione um recurso de criação existente. Selecione Guardar.

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

O procedimento a seguir atribui um recurso a um aplicativo específico.

1. Inicie sessão no portal LUIS. Selecione um aplicativo na lista Meus aplicativos .

2. Vá para Gerenciar>Recursos do Azure:

   

3. Na guia Recurso de previsão ou Recurso de criação, selecione o botão Adicionar recurso de previsão ou Adicionar recurso de criação.

4. Use os campos no formulário para localizar o recurso correto e selecione Salvar.

Sem portal LUIS

Atribuir recurso de previsão sem usar o portal LUIS

Para processos automatizados, como pipelines de CI/CD, você pode automatizar a atribuição de um recurso LUIS a um aplicativo LUIS com as seguintes etapas:

1. Obtenha um token do Azure Resource Manager que é uma cadeia alfanumérica de caracteres. Este token expira, então use-o imediatamente. Você também pode usar o seguinte comando da CLI do Azure.

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

2. Use o token para solicitar os recursos de tempo de execução do LUIS entre assinaturas. Use a API para obter a conta do Azure LUIS à qual sua conta de usuário tem acesso.

   Esta API POST requer os seguintes valores:

   Cabeçalho	Value
   Authorization	O valor de Authorization é Bearer {token}. O valor do token deve ser precedido pela palavra Bearer e por um espaço.
   Ocp-Apim-Subscription-Key	A sua chave de criação.

   A API retorna uma matriz de objetos JSON que representam suas assinaturas LUIS. Os valores retornados incluem a ID da assinatura, o grupo de recursos e o nome do recurso, retornados como AccountName. Encontre o item na matriz que é o recurso LUIS que você deseja atribuir ao aplicativo LUIS.

3. Atribua o token ao recurso LUIS usando a opção Atribuir uma conta do Azure LUIS a uma API de aplicativo .

   Esta API POST requer os seguintes valores:

   Type	Definição	Value
   Cabeçalho	Authorization	O valor de Authorization é Bearer {token}. O valor do token deve ser precedido pela palavra Bearer e por um espaço.
   Cabeçalho	Ocp-Apim-Subscription-Key	A sua chave de criação.
   Cabeçalho	Content-type	application/json
   Querystring	appid	Pelo ID de aplicação do LUIS.
   Corpo		{AzureSubscriptionId: O seu ID de Subscrição, ResourceGroup: Nome do grupo de recursos que tem seu recurso de previsão, AccountName: Nome do seu recurso de previsão}

   Quando essa API é bem-sucedida, ela retorna 201 - created status.

Cancelar a atribuição de um recurso

Quando você cancela a atribuição de um recurso, ele não é excluído do Azure. É apenas desvinculado do LUIS.

Portal LUIS

Cancelar a atribuição de recursos usando o portal LUIS

1. Inicie sessão no portal LUIS e, em seguida, selecione uma aplicação na lista As minhas aplicações .
2. Vá para Gerenciar>Recursos do Azure.
3. Selecione o botão Cancelar atribuição de recurso para o recurso.

Sem portal LUIS

Cancelar a atribuição de recurso de previsão sem usar o portal LUIS

1. Obtenha um token do Azure Resource Manager que é uma cadeia alfanumérica de caracteres. Este token expira, então use-o imediatamente. Você também pode usar o seguinte comando da CLI do Azure.

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

2. Use o token para solicitar os recursos de tempo de execução do LUIS entre assinaturas. Use a API Obter contas do Azure LUIS, à qual sua conta de usuário tem acesso.

   Esta API POST requer os seguintes valores:

   Cabeçalho	Value
   Authorization	O valor de Authorization é Bearer {token}. O valor do token deve ser precedido pela palavra Bearer e por um espaço.
   Ocp-Apim-Subscription-Key	A sua chave de criação.

   A API retorna uma matriz de objetos JSON que representam suas assinaturas LUIS. Os valores retornados incluem a ID da assinatura, o grupo de recursos e o nome do recurso, retornados como AccountName. Encontre o item na matriz que é o recurso LUIS que você deseja atribuir ao aplicativo LUIS.

3. Atribua o token ao recurso LUIS usando a opção Cancelar atribuição de uma conta do Azure LUIS de uma API de aplicativo .

   Esta API DELETE requer os seguintes valores:

   Type	Definição	Value
   Cabeçalho	Authorization	O valor de Authorization é Bearer {token}. O valor do token deve ser precedido pela palavra Bearer e por um espaço.
   Cabeçalho	Ocp-Apim-Subscription-Key	A sua chave de criação.
   Cabeçalho	Content-type	application/json
   Querystring	appid	Pelo ID de aplicação do LUIS.
   Corpo		{AzureSubscriptionId: O seu ID de Subscrição, ResourceGroup: Nome do grupo de recursos que tem seu recurso de previsão, AccountName: Nome do seu recurso de previsão}

   Quando essa API é bem-sucedida, ela retorna 200 - OK status.

Propriedade dos recursos

Um recurso do Azure, como um recurso LUIS, pertence à assinatura que contém o recurso.

Para alterar a propriedade de um recurso, você pode executar uma destas ações:

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

Limites de recursos

Limites de criação de chaves de criação

Você pode criar até 10 chaves de criação por região, por assinatura. As regiões de publicação são diferentes das regiões de criação. Certifique-se de criar um aplicativo na região de criação que corresponda à região de publicação onde você deseja que seu aplicativo cliente esteja localizado. Para obter informações sobre como as regiões de criação são mapeadas para regiões de publicação, consulte Regiões de criação e publicação.

Para obter mais informações, veja os limites dos recursos.

Erros para limites de uso de chaves

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 você exceder sua cota de transação por mês (TPM), receberá um erro HTTP 403.

Alterar o nível de preços

1. No portal do Azure, vá para Todos os recursos e selecione seu recurso

   

2. No menu do lado esquerdo, selecione Nível de preços para ver os níveis de preços disponíveis

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

Exibir métricas de recursos do Azure

Exibir um resumo do uso de recursos do Azure

Você pode exibir informações de uso do LUIS no portal do Azure. A página Visão geral mostra um resumo, incluindo chamadas e erros recentes. Se você fizer uma solicitação de ponto de extremidade LUIS, aguarde até cinco minutos para que a alteração apareça.

Personalizando gráficos de uso de recursos do Azure

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

Alerta de limite total de transações

Se quiser saber quando atingir um determinado limite de transações, por exemplo, 10.000 transações, você pode criar um alerta:

1. No menu do lado esquerdo, selecione Alertas

2. No menu superior, selecione Nova regra de alerta

   

3. Selecione Adicionar condição

   

4. Selecione Total de chamadas

   

5. Role para baixo até a seção Lógica de alerta, defina os atributos como deseja e clique em Concluído

   

6. Para enviar notificações ou invocar ações quando a regra de alerta for acionada, vá para a seção Ações e adicione seu grupo de ações.

   

Redefinir uma chave de criação

Para aplicativos de recursos de criação migrados: se sua chave de criação estiver comprometida, redefina a chave no portal do Azure, na página Chaves do recurso de criação.

Para aplicativos que não foram migrados: a chave é redefinida em todos os seus aplicativos no portal LUIS. Se você criar seus aplicativos por meio das APIs de criação, precisará alterar o valor de Ocp-Apim-Subscription-Key para a nova chave.

Regenerar uma chave do Azure

Você pode regenerar uma chave do Azure na página Chaves no portal do Azure.

Propriedade, acesso e segurança do aplicativo

Um aplicativo é definido por seus recursos do Azure, que são determinados pela assinatura do proprietário.

Você pode mover seu aplicativo LUIS. Use os seguintes recursos para ajudá-lo a fazer isso usando o portal do Azure ou a CLI do Azure:

• Mover um recurso para um novo grupo de recursos ou subscrição
• Mover um recurso dentro da mesma subscrição ou entre subscrições

Próximos passos

• Saiba como usar versões para controlar o ciclo de vida do aplicativo.