Guide pratique pour créer et gérer des ressources LUIS

Créer une ressource de création LUIS à l’aide du portail LUIS

1. Connectez-vous au portail LUIS, sélectionnez votre pays/région, puis acceptez les conditions d’utilisation. Si vous voyez la section Mes applications dans le portail, il existe déjà une ressource LUIS et vous pouvez ignorer l’étape suivante.

2. Dans la fenêtre Choisir une ressource de création qui s’affiche, recherchez votre abonnement Azure et la ressource de création LUIS. Si vous n’avez pas de ressource, vous pouvez en créer une nouvelle.

   

   Quand vous créez une ressource de création, fournissez les informations suivantes :

   • Nom du locataire : locataire auquel votre abonnement Azure est associé.
   • Nom de l’abonnement Azure : abonnement qui sera facturé pour la ressource.
   • Nom du groupe de ressources Azure : nom de groupe de ressources personnalisé que vous choisissez ou créez. Les groupes de ressources vous permettent de regrouper des ressources Azure pour l’accès et la gestion.
   • Nom de la ressource Azure : nom personnalisé que vous choisissez, utilisé comme partie de l’URL pour vos requêtes de point de terminaison de création et de prédiction.
   • Niveau tarifaire : le niveau tarifaire détermine le nombre maximal de transactions par seconde et par mois.

Créer une ressource de prédiction LUIS à l’aide du portail LUIS

1. Accédez à l’onglet Gérer dans votre application.

2. Dans le menu de navigation gauche, sélectionnez Ressources Azure.

3. Sélectionnez le bouton Ajouter une ressource de prédiction.

   

   Si vous disposez déjà d’une ressource de prédiction, ajoutez-la. Dans le cas contraire, sélectionnez Créer une ressource de prédiction.

   

Créer des ressources LUIS sans utiliser le portail LUIS

Utilisez Azure CLI pour créer chaque ressource individuellement.

1. Connectez-vous à Azure CLI :

   az login
   

   Cette commande ouvre un navigateur pour vous permettre de sélectionner le compte approprié et de fournir l’authentification nécessaire.

2. Créez une ressource de création LUIS dont le genre est LUIS.Authoring et le nom my-luis-authoring-resource. Créez-la dans le groupe de ressources existant nommé my-resource-group pour la région westus.

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

3. Créez une ressource de point de terminaison de prédiction LUIS dont le genre est LUIS et le nom my-luis-prediction-resource. Créez-la dans le groupe de ressources existant nommé my-resource-group pour la région westus. Si vous souhaitez avoir un débit plus élevé que celui du niveau Gratuit, passez de F0 à S0. Découvrez plus en détail les niveaux tarifaires et le débit.

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

Affecter des ressources à l’aide du portail LUIS

Affecter une ressource de création à toutes vos applications

La procédure suivante affecte la ressource de création à toutes les applications.

1. Connectez-vous au portail LUIS.
2. Dans le coin supérieur droit, sélectionnez votre compte d’utilisateur, puis Paramètres.
3. Dans la page Paramètres utilisateur, sélectionnez Ajouter une ressource de création, puis sélectionnez une ressource de création existante. Sélectionnez Enregistrer.

Affecter une ressource à l’aide d’une application spécifique

La procédure suivante affecte une ressource à une application spécifique.

1. Connectez-vous au portail LUIS. Sélectionnez une application dans la liste My apps (Mes applications).

2. Accédez à Gérer>Ressources Azure :

   

3. Sous l’onglet Ressource de prédiction ou Ressource de création, sélectionnez le bouton Ajouter une ressource de prédiction ou Ajouter une ressource de création.

4. Utilisez les champs du formulaire pour trouver la ressource appropriée, puis sélectionnez Enregistrer.

Attribuer une ressource de prédiction sans utiliser le portail LUIS

Pour les processus automatisés comme les pipelines CI/CD, vous pouvez automatiser l’affectation d’une ressource LUIS à une application LUIS en effectuant les étapes suivantes :

1. Obtenez un jeton Azure Resource Manager qui est une chaîne alphanumérique de caractères. Ce jeton a un délai d’expiration. Veillez donc à l’utiliser immédiatement. Vous pouvez également utiliser la commande Azure CLI suivante.

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

2. Utilisez le jeton pour demander les ressources de runtime LUIS parmi les différents abonnements. Utilisez l’API pour obtenir le compte LUIS Azure auquel votre compte d’utilisateur a accès.

   Cette API POST nécessite les valeurs suivantes :

   En-tête	Valeur
   Authorization	La valeur de Authorization est Bearer {token}. La valeur du jeton doit être précédée du mot Bearer et d’un espace.
   Ocp-Apim-Subscription-Key	Votre clé de création.

   L’API retourne un tableau d’objets JSON qui représentent vos abonnements LUIS. Les valeurs, qui incluent l’ID d’abonnement, le groupe de ressources et le nom de ressource, sont retournées en tant que AccountName. Recherchez dans le tableau l’élément correspondant à la ressource LUIS que vous souhaitez affecter à l’application LUIS.

3. Affectez le jeton à la ressource LUIS à l’aide de l’API d’affectation de compte LUIS Azure à une application.

   Cette API POST nécessite les valeurs suivantes :

   Type	Paramètre	Valeur
   En-tête	Authorization	La valeur de Authorization est Bearer {token}. La valeur du jeton doit être précédée du mot Bearer et d’un espace.
   En-tête	Ocp-Apim-Subscription-Key	Votre clé de création.
   En-tête	Content-type	application/json
   Querystring	appid	L’ID d’application LUIS.
   body		{AzureSubscriptionId : votre ID d’abonnement, ResourceGroup : nom du groupe de ressources qui contient votre ressource de prédiction, AccountName : nom de votre ressource de prédiction}

   Quand cette API réussit son exécution, elle retourne 201 - created status.

Annuler l’affectation de ressources à l’aide du portail LUIS

1. Connectez-vous au portail LUIS, puis sélectionnez une application dans la liste Mes applications.
2. Accédez à Gérer>Ressources Azure.
3. Sélectionnez le bouton Annuler l’affectation de la ressource pour la ressource.

Annuler l'attribution d'une ressource de prédiction sans utiliser le portail LUIS

1. Obtenez un jeton Azure Resource Manager qui est une chaîne alphanumérique de caractères. Ce jeton a un délai d’expiration. Veillez donc à l’utiliser immédiatement. Vous pouvez également utiliser la commande Azure CLI suivante.

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

2. Utilisez le jeton pour demander les ressources de runtime LUIS parmi les différents abonnements. Utilisez l’API de récupération des comptes LUIS Azure, à laquelle votre compte d’utilisateur a accès.

   Cette API POST nécessite les valeurs suivantes :

   En-tête	Valeur
   Authorization	La valeur de Authorization est Bearer {token}. La valeur du jeton doit être précédée du mot Bearer et d’un espace.
   Ocp-Apim-Subscription-Key	Votre clé de création.

   L’API retourne un tableau d’objets JSON qui représentent vos abonnements LUIS. Les valeurs, qui incluent l’ID d’abonnement, le groupe de ressources et le nom de ressource, sont retournées en tant que AccountName. Recherchez dans le tableau l’élément correspondant à la ressource LUIS que vous souhaitez affecter à l’application LUIS.

3. Affectez le jeton à la ressource LUIS à l’aide de l’API Annuler l’affectation d’un compte LUIS Azure d’une application.

   Cette API de suppression nécessite les valeurs suivantes :

   Type	Paramètre	Valeur
   En-tête	Authorization	La valeur de Authorization est Bearer {token}. La valeur du jeton doit être précédée du mot Bearer et d’un espace.
   En-tête	Ocp-Apim-Subscription-Key	Votre clé de création.
   En-tête	Content-type	application/json
   Querystring	appid	L’ID d’application LUIS.
   body		{AzureSubscriptionId : votre ID d’abonnement, ResourceGroup : nom du groupe de ressources qui contient votre ressource de prédiction, AccountName : nom de votre ressource de prédiction}

   Quand cette API réussit son exécution, elle retourne 200 - OK status.