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

   

Crie recursos LUIS sem utilizar o portal LUIS

Use a CLI do Azure para criar cada recurso individualmente.

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

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

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.