Como criar e gerenciar recursos 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.

   

Criar recursos do LUIS sem usar o portal do LUIS

Use a CLI do Azure para criar cada recurso individualmente.

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 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.

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 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.

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.