Compétences ML

Consultez cette section pour obtenir des exemples d'utilisation des compétences ML.

Économisez des coûts d'infrastructure grâce aux API AI Center

Avec les requêtes d'API, vous pouvez modifier l'état d'une compétence ML de manière programmatique. Ces API peuvent être utilisées même dans un workflow d'automatisation pour déployer et annuler le déploiement d'une compétence ML, optimisant ainsi la disponibilité de l'infrastructure et permettant de réduire les coûts. Consultez l'ensemble complet d'API AI Center documenté dans swagger.

Notez que accountname et tenantname sont spécifiques à votre compte. Pour plus d'informations, consultez la liste des API .

Vous utilisez les API AI Center pour :

1. Trouver l’ID de compétence ML de sampleClassifierSkill
2. Arrêter (annuler le déploiement) de la compétence ML
3. Démarrez (redéploiement) et vérifiez la mise à jour de l’état.

En novembre 2022, nous avons annoncé la disponibilité d'API pour interagir de manière programmatique avec chaque composant d'AI Center. Vous pouvez désormais gérer des ensembles de données, entraîner des modèles ML et déployer des compétences ML à l'aide d'API, sans avoir à utiliser l'interface utilisateur.

L'un des principaux cas d'utilisation pour tirer parti des API consiste à gérer le statut de déploiement d'une compétence ML. Selon l'automatisation, vous n'avez peut-être pas besoin qu'une compétence ML soit active tout le temps. Annuler le déploiement des compétences ML lorsqu'elles ne sont pas utilisées peut vous aider à économiser sur les coûts matériels (AI Units).

Les étapes pour accéder aux API AI Center sont :

1. Enregistrement d'une application externe (configuration unique)
2. Génération d'un jeton d'authentification (renouvellement à l'expiration)
3. Passer des appels API AI Center

Remarque : les deux premières étapes appliquent le contrôle d'accès en vous assurant que votre application est enregistrée et authentifiée

Enregistrement d'une application externe

Pour utiliser les API, votre application doit s'enregistrer en tant qu'application externe avec une étendue AI Center.

1. Dans le panneau de navigation de gauche, accédez à la page Admin et sélectionnez External Applications.
2. Pour ajouter une nouvelle application externe, sélectionnez + Add Application

   et nommez-le.

   Remarque : seul le typeconfidential application peut accéder aux API AI Center.
3. Pour activer l'étendue AI Center sur l'application externe :
   1. Sélectionner Add scope
   2. Choisissez AI Center API Access (preview) dans la liste déroulante des ressources.
   3. Accédez à l'onglet Application Scope
   4. Sélectionnez les API auxquelles vous souhaitez autoriser l'accès.
   Dans l'exemple ci-dessous, toutes les API sont sélectionnées pour plus de simplicité, mais vous pouvez choisir d'attribuer à des API spécifiques l'accès à des applications externes spécifiques.
   
   

   

   
   
4. Sélectionnez Add. Une fenêtre contextuelle avec l' ID d'application et une clé secrète d'application est générée.
   Astuce : Vous pouvez afficher l' ID d'application et la clé secrète de l'application à tout moment à partir de l'activité Modifier l'application externe ( Edit External Application). Ces informations d'identification sont utilisées pour générer un jeton d'authentification à l'étape suivante. Consultez des informations supplémentaires sur la gestion d'applications externes.
   
   

   

   
   

Génération d'un jeton d'authentification

Pour l'authentification et l'accès sécurisé, l'application externe demande un jeton d'accès à partir du serveur d'identité UiPath. Le jeton d'authentification généré expire dans une heure, après quoi vous devez générer un nouveau jeton d'authentification.

Si vous souhaitez utiliser Postman, vous pouvez vous inscrire gratuitement et choisir d'utiliser l'interface Web de Postman ou l'application téléchargeable. Consultez le site officiel de Postman .

1. Générez une requête POST au point de terminaison d'Identity Server https://cloud.uipath.com/identity_/connect/token qui inclut les éléments suivants dans le corps de la requête.

   client_id: App ID from previous step
   client_secret: App Secret from previous step
   grant_type: “client_credentials”

2. Définissez grant_type sur client_credentials.

Utilisez le type de contenu application/x-www-form-urlencoded pour Postman.

Cette requête génère un jeton d'authentification similaire à celui ci-dessous, répertoriant les autorisations activées pour cette application externe. Utilisez ce jeton d'authentification lors des appels d'API AI Center.

Consultez les informations supplémentaires sur les informations d' identification et les jetons d'authentification.

Passer des appels API AI Center

Les appels d'API respectent la structure suivante : https://cloud.uipath.com/accountname/tenantname/aifabric_/ où « accountname» et « tenantname » sont spécifiques à votre compte. La plupart des API ont besoin des informations suivantes :

1. ID de compte et ID de locataire. Vous pouvez trouver les informations sur le compte et le locataire dans la section d'informations de profil du locataire. Voir les informations de profil.
   
   

   

   
   
2. Autorisation. Le champ d'autorisation doit être renseigné avec le jeton d'authentification généré à l'étape précédente.
   Attention : Lorsque vous utilisez le jeton d'authentification, préfixez-le avec Bearer comme dans la capture d'écran ci-dessous.

Vous pouvez désormais accéder à des API spécifiques. Utilisez sampleClassifierSkill pour cet exemple. Dans la liste Compétences ML, vous pouvez voir que cette compétence existe et qu'elle est actuellement dans le statut Disponible ( Available ).

Rechercher les détails de la compétence ML

À l'aide de l'appel GET ML Skills , vous pouvez récupérer une liste de toutes les compétences ML du compte et du locataire. Vous pouvez également ajouter le nom de la compétence ML dans le cadre de la requête pour rechercher une compétence ML spécifique et récupérer ses détails. Dans ce cas, vous trouvez la compétence ML idpour le sampleClassifierSkill

GET /ai-deployer/v1/mlskills?name=sampleClassifierSkill

Dans la réponse ci-dessous, les champs clés sont surlignés en jaune. Vérifiez que le sampleClassifierSkill est dans l'état Disponible (Available). La compétence ML id est utilisée dans les API suivantes pour mettre à jour l'état.

Arrêter la compétence ML

Pour arrêter une compétence ML :

• La requête la demande doit contenir l'action de mise à jour stop et la compétence ML id
• L'en-tête doit contenir des informations de compte, de locataire et d'authentification

PUT /ai-deployer/v2/mlskills/stop/{mlSkillId}

La réponse montre que le changement de statut de la compétence ML a réussi :

En vérifiant l'IU, vous pouvez vérifier que sampleClassifierSkill n'a pas été déployé.

Reprendre la compétence ML

Pour redémarrer (déployer) la compétence ML, effectuez les appels d'API en ayant updateType défini sur Reprendre (Resume).

POST /ai-deployer/v1/mlskills/{mlSkillId}?updateType=RESUME

À partir de la réponse, vous pouvez voir que la demande a réussi et que l'état de la compétence est passé à Déploiement(Deploying).

Attendez que la compétence soit disponible et vérifiez le statut de la compétence ML à l'aide de l'API de détails GET ML Skill .

À partir de la réponse, la compétence ML est maintenant déployée et disponible. Vérifiez la disponibilité de la compétence dans l'interface utilisateur. Désormais, vos automatisations peuvent tirer parti de la compétence ML déployée sampleClassifierSkill dans les workflows pour faire des prédictions.

Mettre à jour le déploiement de compétences ML à l'aide d'une API

Pour accéder aux API AI Center :

1. Enregistrer une application externe (configuration unique).
2. Générez un jeton d'authentification (renouvelé à l'expiration).
3. Passez des appels API AI Center.

Remarque : les deux premières étapes appliquent le contrôle d'accès en vous assurant que votre application est enregistrée et authentifiée. Pour accéder à l'application, vous devez enregistrer et authentifier l'application. (étapes 1 et 2)

Enregistrement d'une application externe

Pour utiliser ces API, votre application doit être enregistrée en tant qu'application externe dans l'étendue AI Center.

1. Accédez à la page Admin dans le panneau de navigation de gauche et sélectionnez Applications externes ( External Applications).
2. Sélectionnez + Ajouter une application (Add Application) et attribuez-lui un nom pour ajouter une nouvelle application externe.
   Remarque : seul le type d'application confidentiel peut accéder aux API AI Center.
3. Sélectionnez Ajouter une étendue (Add scope ) pour activer l'étendue AI Center pour l'application externe.
   • Choisissez Accès à l'API AI Center (aperçu) (AI Center API Access (preview)) dans la liste déroulante Ressource (Resource).
   • Accédez à l'onglet Étendue de l'application ( Application Scope ) et choisissez les API auxquelles vous souhaitez donner accès aux applications externes. Dans l'exemple ci-dessous, vous avez sélectionné toutes les API pour plus de simplicité.
     
     

     

     
     
4. Une fenêtre contextuelle avec l'ID d'application et une clé secrète d'application confirme que l'application a été ajoutée avec succès. Vérifiez l' ID de l'application et la clé secrète de l'application à tout moment à partir de l ' application externe Modifier l'application externe (Edit External).
   Remarque : utilisez ces informations d'identification pour générer un jeton d'authentification lors de l'étape suivante.
   
   

   

   
   

Consultez la page Gestion d'applications externes (Managing external applications ) pour plus d'informations.

Génération d'un jeton d'authentification

L'application externe doit demander un jeton d'accès à l'Identity Server UiPath pour l'authentification et l'accès sécurisé.

Remarque : le jeton d'authentification expire dans une heure. Une fois ce délai écoulé, vous devrez en générer une nouvelle.

Par souci de simplicité, nous utilisons Postman dans ce tutoriel. Vous pouvez enregistrer 10 jetons gratuitement et utiliser leur interface Web, application ou tout autre outil.

Générez une requête POST au point de terminaison du serveur d'identité qui inclut les éléments suivants dans le corps de la requête :

• client_id: ID de l'application de l'étape précédente.
• client_secret: secret de l'application de l'étape précédente.
• grant_type: informations_informations_d'identification.

Sélectionnez application/x-www-form-urlencoded comme type de contenu si vous utilisez Postman.

Cette requête crée un jeton d'authentification, utilisé pour les appels d'API AI Center :

Vous pouvez également voir les autorisations activées pour cette application externe.

Consultez les informations supplémentaires sur les informations d’identification et les jetons d’authentification dans la page Applications externes (OAuth) .

Passer des appels API AI Center

Les appels d'API suivent la structure https://cloud.uipath.com/accountname/tenantname/aifabric_/ 10 , où accountname et tenantname sont spécifiques à votre compte.

La plupart des API ont besoin des informations suivantes :

• Account ID et Tenant ID. Vérifiez les détails du compte et du locataire dans la section d' informations de profil du locataire.
  
  

  

  
  
• Authorization Le champ Autorisation (Authorization) est renseigné avec le jeton d'authentification généré à l'étape précédente.

Vous pouvez désormais accéder à des API spécifiques.

Dans la liste Compétences ML, sampleClassifierSkill (utilisé à titre d'exemple) est actuellement à l'état Disponible (Available).

Utiliser les API AI Center pour :

• Recherchez l' ID de compétence ML de sampleClassifierSkill.
• Arrêter (annuler le déploiement) de la compétence ML.
• Démarrez (redéploiement) et vérifiez la mise à jour de l’état.

Rechercher les détails de la compétence ML

Avec l'appel GET ML Skills , vous pouvez récupérer toutes les compétences ML de votre compte et locataire.

Pour rechercher une compétence ML spécifique et obtenir ses détails, incluez son nom dans la requête : GET /ai-deployer/v1/mlskills?name=sampleClassifierSkill

Dans ce cas, nous cherchons l'ID de la compétence ML pour le sampleClassifierSkill.

Remarque : Lorsque vous utilisez le jeton d'authentification, ajoutez-y le préfixe Bearer.

Dans la réponse ci-dessous, les champs clés sont surlignés en jaune. Utilisez l’ID ML Skill dans le APIs suivant pour modifier l’état :

Mettre à jour les réplicas de compétence ML

Utilisez l'appel UPDATE ML Skill pour modifier la configuration du déploiement d'une compétence ML spécifique.

Dans l'exemple ci-dessous, nous modifions le nombre de répliques en incluant le nouveau numéro dans le corps de la demande.