Como criar e gerenciar recursos do LUIS

Importante

O LUIS será desativado em 1º de outubro de 2025 e, a partir de 1º de abril de 2023, você não poderá criar novos recursos do LUIS. É recomendável migrar seus aplicativos LUIS para a compreensão da linguagem coloquial a fim de usufruir 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 tipo de preço está disponível para o recurso de criação do LUIS, a camada gratuita (F0), que oferece:

• 1 milhão transações de criação
• 1\.000 solicitações de ponto de extremidade de previsão de teste por mês.

Você pode usar as APIs programáticas do LUIS v3.0 – versão prévia para gerenciar recursos de criação.

Recurso de previsã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 tipos de preço 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 gratuitas mensalmente.
• Recurso de previsão padrão (S0), que é a camada paga.

Você pode usar a APIs programáticas do LUIS v3.0 – versão prévia para gerenciar recursos de previsão.

Observação

• Você também pode usar um recurso de vários serviços para obter um único ponto de extremidade que pode ser usado para vários serviços de IA do Azure.
• O LUIS fornece dois tipos de recursos F0 (camada gratuita): um para a criação de transações e outro para transações de previsão. Se você está ficando sem cota livre para transações de previsão, verifique se está usando o recurso de previsão F0, que fornece 10.000 transações gratuitas mensalmente, e não o recurso de criação, que oferece 1.000 transações de previsão por mês.
• É importante criar aplicativos LUIS nas regiões em que você quer publicar e consultar.

Criar recursos do LUIS

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

Portal do LUIS

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

1. Entrar no portal do LUIS, selecionar seu país/região e concordar com os termos de uso. Se você vir a seção Meus Aplicativos no portal, um recurso do LUIS já existirá, e você poderá ignorar a próxima etapa.

2. Na janela Escolher uma criação exibida, encontre sua assinatura do Azure e o recurso de criação do LUIS. Se você não tiver um recurso, poderá criar um.

   

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

   • Nome do locatário: 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: o nome de um grupo de recursos personalizado que você escolher ou criar. Os grupos de recursos permitem agrupar os recursos do Azure para acesso e gerenciamento.
   • Nome do recurso do Azure: um nome personalizado que você escolher, usado como parte da URL para as consultas de ponto de extremidade de criação e previsão.
   • Tipo de preço: o tipo de preço determina a transação máxima por segundo e mês.

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

1. Acesse a guia Gerenciar no aplicativo.

2. No painel de navegação à esquerda, selecione Recursos do Azure.

3. Selecione 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 o portal do LUIS

Criar recursos do LUIS sem usar o portal do LUIS

Use a CLI do Azure para criar cada recurso individualmente.

Dica

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

1. Entre na CLI do Azure:

   az login
   

   Esse comando abre um navegador para você selecionar a conta correta e fazer a autenticação.

2. Crie um recurso de criação LUIS de tipo LUIS.Authoring, chamado my-luis-authoring-resource. Crie-o no grupo de recursos existente chamado my-resource-group, da região westus.

   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 chamado my-resource-group, da região westus. Para ter uma taxa de transferência mais alta que a oferecida pela camada gratuita, altere F0 para S0. Saiba mais sobre os tipos de preço e a 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

A criação de um recurso não significa necessariamente que ele será colocado em uso: você precisa atribuí-lo aos seus aplicativos. É possível atribuir um recurso de criação a um ou todos os aplicativos no LUIS.

Portal do LUIS

Atribuir recursos no portal do 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. Entre no portal do LUIS.
2. No canto superior direito, selecione a conta de usuário e as Configurações.
3. Na página Configurações do Usuário, clique em Adicionar recurso de criação e selecione um recurso de criação existente. Selecione Salvar.

Atribuir um recurso a um aplicativo específico

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

1. Entre no portal do LUIS. Selecione um aplicativo na lista Meus aplicativos.

2. Acesse Gerenciar>Recursos do Azure:

   

3. Na guia Recurso de previsão ou Recurso de criação, clique no 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, em seguida, clique em Salvar.

Sem o portal do LUIS

Atribuir um recurso de previsão sem usar o portal do LUIS

Para processos automatizados, como pipelines de CI/CD, é possível automatizar a atribuição de um recurso do LUIS a um aplicativo do LUIS usando as seguintes etapas:

1. Obter um token do Azure Resource Manager, que é uma cadeia de caracteres alfanuméricos. Esse token expira, então use-o imediatamente. Você também pode usar o comando a seguir 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 runtime LUIS nas assinaturas. Use a API para obter a conta do LUIS Azure à que sua conta de usuário tem acesso.

   Essa API POST requer os seguintes valores:

   Cabeçalho	Valor
   Authorization	O valor de Authorization é Bearer {token}. O valor do token precisa ser precedido pela palavra Bearer e um espaço.
   Ocp-Apim-Subscription-Key	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. Localize um item na matriz que é o recurso do LUIS que você quer atribuir ao aplicativo LUIS.

3. Atribua o token ao recurso do LUIS com a API Atribuir contas do Azure do LUIS a um aplicativo.

   Essa API POST requer os seguintes valores:

   Tipo	Configuração	Valor
   parâmetro	Authorization	O valor de Authorization é Bearer {token}. O valor do token precisa ser precedido pela palavra Bearer e um espaço.
   parâmetro	Ocp-Apim-Subscription-Key	Sua chave de criação.
   parâmetro	Content-type	application/json
   Querystring	appid	A ID do aplicativo de LUIS.
   Corpo		{AzureSubscriptionId: sua ID de assinatura, ResourceGroup: nome do grupo de recursos que tem o recurso de previsão, AccountName: nome do seu recurso de previsão}

   Quando essa API for bem-sucedida, ela retornará 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. Ela é apenas desvinculado do LUIS.

Portal do LUIS

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

1. Entre no portal do LUIS e escolha o aplicativo na lista Meus aplicativos.
2. Acesse Gerenciar>Recursos do Azure.
3. Escolha o botão Cancelar a atribuição de recursos para o recurso.

Sem o portal do LUIS

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

1. Obter um token do Azure Resource Manager, que é uma cadeia de caracteres alfanuméricos. Esse token expira, então use-o imediatamente. Você também pode usar o comando a seguir 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 runtime LUIS nas assinaturas. Use API para obter as contas do Azure no LUIS, à qual sua conta de usuário tem acesso.

   Essa API POST requer os seguintes valores:

   Cabeçalho	Valor
   Authorization	O valor de Authorization é Bearer {token}. O valor do token precisa ser precedido pela palavra Bearer e um espaço.
   Ocp-Apim-Subscription-Key	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. Localize um item na matriz que é o recurso do LUIS que você quer atribuir ao aplicativo LUIS.

3. Atribua o token ao recurso do LUIS com a API Cancelar a atribuição de contas do LUIS Azure de um aplicativo.

   Essa API DELETE requer os seguintes valores:

   Tipo	Configuração	Valor
   parâmetro	Authorization	O valor de Authorization é Bearer {token}. O valor do token precisa ser precedido pela palavra Bearer e um espaço.
   parâmetro	Ocp-Apim-Subscription-Key	Sua chave de criação.
   parâmetro	Content-type	application/json
   Querystring	appid	A ID do aplicativo de LUIS.
   Corpo		{AzureSubscriptionId: sua ID de assinatura, ResourceGroup: nome do grupo de recursos que tem o recurso de previsão, AccountName: nome do seu recurso de previsão}

   Quando essa API for bem-sucedida, ela retornará 200 - OK status.

Propriedade do recurso

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:

• Transferir a propriedade da sua assinatura.
• Exportar o aplicativo LUIS como um arquivo e, em seguida, importá-lo em uma assinatura diferente. A exportação está disponível na página Meus aplicativos no portal do LUIS.

Limites de recursos

Limites de criação de chave de criação

Você pode criar até dez chaves de criação por região, por assinatura. Regiões de publicação são diferentes de regiões de criação. Crie um aplicativo na região de criação que corresponde à região de publicação em que você quer que o aplicativo cliente esteja localizado. Para saber mais sobre como as regiões de criação são mapeadas para regiões de publicação, confira Regiões de criação e publicação.

Consulte limites do recurso para saber mais.

Erros de limites de uso de chave

Os limites de uso são baseados no tipo de preço.

Se exceder sua cota de transações por segundo (TPS), você receberá um erro HTTP 429. Se exceder sua cota de TPM (transações por mês), você receberá um erro HTTP 403.

Alterar o tipo de preço

1. No portal do Azure, acesse Todos os recursos e escolha seu recurso

   

2. No menu do lado esquerdo, escolha Tipo de preço para ver os tipos de preço disponíveis

3. Escolha o tipo de preço e clique em Escolher para salvar a alteração. Quando a alteração de preços for concluída, uma notificação será exibida no canto superior direito com a atualização do tipo de preço.

Exibir métricas do recurso 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. Se você fizer uma solicitação de ponto de extremidade LUIS, aguarde até cinco minutos para que a alteração seja exibida.

Personalizar os gráficos de uso de recursos do Azure

A página Métricas mostra uma visão mais detalhada dos dados. É possível configurar os gráficos de métricas de um período e uma métrica específicos.

Alerta de limite total de transações

Para saber se atingiu um determinado limite de transações, por exemplo, 10.000 transações, crie um alerta:

1. No menu lateral esquerdo, escolha Alertas

2. No menu superior, escolha Nova regra de alerta

   

3. Selecione Adicionar condição

   

4. Escolher Total de chamadas

   

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

   

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

   

Redefinir a chave de criação

Para aplicativos do recurso de criação migrados: se a 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 do LUIS. Se você criar seus aplicativos por meio de APIs de criador, você precisa 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 fazer isso usando o portal do Azure ou a CLI do Azure:

• Mover um aplicativo entre os recursos de criação do LUIS
• Mover recursos para um novo grupo de recursos ou assinatura
• Mover um recurso dentro da mesma assinatura ou entre assinaturas

Próximas etapas

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